8000 GitHub - srini387/strix: Open-source AI agents for penetration testing
[go: up one dir, main page]

Skip to content

srini387/strix

ย 
ย 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

72 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

Strix Logo

Strix

Open-source AI Hackers to secure your Apps

Python PyPI PyPI Downloads License

GitHub Stars Discord Website

usestrix%2Fstrix | Trendshift


Strix Demo

Tip

New! Strix now integrates seamlessly with GitHub Actions and CI/CD pipelines. Automatically scan for vulnerabilities on every pull request and block insecure code before it reaches production!


๐Ÿฆ‰ Strix Overview

Strix are autonomous AI agents that act just like real hackers - they run your code dynamically, find vulnerabilities, and validate them through actual proof-of-concepts. Built for developers and security teams who need fast, accurate security testing without the overhead of manual pentesting or the false positives of static analysis tools.

  • Full hacker toolkit out of the box
  • Teams of agents that collaborate and scale
  • Real validation with PoCs, not false positives
  • Developerโ€‘first CLI with actionable reports
  • Autoโ€‘fix & reporting to accelerate remediation

๐ŸŽฏ Use Cases

  • Detect and validate critical vulnerabilities in your applications.
  • Get penetration tests done in hours, not weeks, with compliance reports.
  • Automate bug bounty research and generate PoCs for faster reporting.
  • Run tests in CI/CD to block vulnerabilities before reaching production.

๐Ÿš€ Quick Start

Prerequisites:

  • Docker (running)
  • Python 3.12+
  • An LLM provider key (or a local LLM)
# Install
pipx install strix-agent

# Configure AI provider
export STRIX_LLM="openai/gpt-5"
export LLM_API_KEY="your-api-key"

# Run security assessment
strix --target ./app-directory

First run pulls the sandbox Docker image. Results are saved under agent_runs/<run-name>.

๐Ÿ† Enterprise Platform

Want to skip the setup? Try our cloud-hosted version: usestrix.com

Our managed platform provides:

  • ๐Ÿ“ˆ Executive Dashboards
  • ๐Ÿง  Custom Fine-Tuned Models
  • โš™๏ธ CI/CD Integration
  • ๐Ÿ” Large-Scale Scanning
  • ๐Ÿ”Œ Third-Party Integrations
  • ๐ŸŽฏ Enterprise Support

Get Enterprise Demo โ†’

โœจ Features

๐Ÿ› ๏ธ Agentic Security Tools

  • Full HTTP Proxy - Full request/response manipulation and analysis
  • Browser Automation - Multi-tab browser for testing of XSS, CSRF, auth flows
  • Terminal Environments - Interactive shells for command execution and testing
  • Python Runtime - Custom exploit development and validation
  • Reconnaissance - Automated OSINT and attack surface mapping
  • Code Analysis - Static and dynamic analysis capabilities
  • Knowledge Management - Structured findings and attack documentation

๐ŸŽฏ Comprehensive Vulnerability Detection

  • Access Control - IDOR, privilege escalation, auth bypass
  • Injection Attacks - SQL, NoSQL, command injection
  • Server-Side - SSRF, XXE, deserialization flaws
  • Client-Side - XSS, prototype pollution, DOM vulnerabilities
  • Business Logic - Race conditions, workflow manipulation
  • Authentication - JWT vulnerabilities, session management
  • Infrastructure - Misconfigurations, exposed services

๐Ÿ•ธ๏ธ Graph of Agents

  • Distributed Workflows - Specialized agents for different attacks and assets
  • Scalable Testing - Parallel execution for fast comprehensive coverage
  • Dynamic Coordination - Agents collaborate and share discoveries

๐Ÿ’ป Usage Examples

Default Usage

# Local codebase analysis
strix --target ./app-directory

# Repository security review
strix --target https://github.com/org/repo

# Black-Box Web application assessment
strix --target https://your-app.com

# Grey-Box Security Assesment
strix --target https://your-app.com --instruction "Perform authenticated testing using the following credentials user:pass"

# Multi-target white-box testing (source code + deployed app)
strix -t https://github.com/org/app -t https://your-app.com

# Focused testing with instructions
strix --target api.your-app.com --instruction "Focus on business logic flaws and IDOR vulnerabilities"

๐Ÿค– Headless Mode

Run Strix programmatically without interactive UI using the -n/--non-interactive flagโ€”perfect for servers and automated jobs. The CLI prints real-time vulnerability findings, and the final report before exiting. Exits with non-zero code when vulnerabilities are found.

strix -n --target https://your-app.com

๐Ÿ”„ CI/CD (GitHub Actions)

Strix can be added to your pipeline to run a security test on pull requests with a lightweight GitHub Actions workflow:

name: strix-penetration-test

on:
  pull_request:

jobs:
  security-scan:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Install Strix
        run: pipx install strix-agent

      - name: Run Strix
        env:
          STRIX_LLM: ${{ secrets.STRIX_LLM }}
          LLM_API_KEY: ${{ secrets.LLM_API_KEY }}

        run: strix -n -t ./

โš™๏ธ Configuration

export STRIX_LLM="openai/gpt-5"
export LLM_API_KEY="your-api-key"

# Optional
export LLM_API_BASE="your-api-base-url"  # if using a local model, e.g. Ollama, LMStudio
export PERPLEXITY_API_KEY="your-api-key"  # for search capabilities

OpenAI's GPT-5 (openai/gpt-5) and Anthropic's Claude Sonnet 4.5 (anthropic/claude-sonnet-4-5) work best with Strix, but we support many other options.

๐Ÿค Contributing

We welcome contributions from the community! There are several ways to contribute:

Code Contributions

See our Contributing Guide for details on:

  • Setting up your development environment
  • Running tests and quality checks
  • Submitting pull requests

Prompt Modules Collection

Help expand our collection of specialized prompt modules for AI agents:

๐Ÿ‘ฅ Join Our Community

Have questions? Found a bug? Want to contribute? Join our Discord!

๐ŸŒŸ Support the Project

Love Strix? Give us a โญ on GitHub!

Warning

Only test apps you own or have permission to test. You are responsible for using Strix ethically and legally.

About

Open-source AI agents for penetration testing

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 65.3%
  • Jinja 32.4%
  • Dockerfile 1.1%
  • Other 1.2%
0