{"id":44134005,"url":"https://github.com/zakirkun/guardian-cli","last_synced_at":"2026-05-25T14:08:47.691Z","repository":{"id":332029079,"uuid":"1120886225","full_name":"zakirkun/guardian-cli","owner":"zakirkun","description":"Guardian is a production-ready AI-powered penetration testing automation CLI tool that leverages Google Gemini and LangChain to orchestrate intelligent, step-by-step penetration testing workflows while maintaining ethical hacking standards.","archived":false,"fork":false,"pushed_at":"2026-02-03T16:48:07.000Z","size":91,"stargazers_count":749,"open_issues_count":1,"forks_count":157,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-02-03T20:52:35.123Z","etag":null,"topics":["automation","gemini-ai","generative-ai","pentest-tool"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zakirkun.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-22T05:21:52.000Z","updated_at":"2026-02-03T20:23:07.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/zakirkun/guardian-cli","commit_stats":null,"previous_names":["zakirkun/guardian-cli"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zakirkun/guardian-cli","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zakirkun%2Fguardian-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zakirkun%2Fguardian-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zakirkun%2Fguardian-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zakirkun%2Fguardian-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zakirkun","download_url":"https://codeload.github.com/zakirkun/guardian-cli/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zakirkun%2Fguardian-cli/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29664401,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-20T19:49:36.704Z","status":"ssl_error","status_checked_at":"2026-02-20T19:44:05.372Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["automation","gemini-ai","generative-ai","pentest-tool"],"created_at":"2026-02-08T23:00:17.391Z","updated_at":"2026-05-25T14:08:47.675Z","avatar_url":"https://github.com/zakirkun.png","language":"Python","funding_links":[],"categories":["Pentest \u0026 Red Teaming Agents","Attack Techniques \u0026 Red Teaming"],"sub_categories":["AI-Assisted Offensive Security"],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003cimg src=\"docs/logo.svg\" alt=\"Guardian Logo\" width=\"200\" /\u003e\n\n# 🔐 Guardian\n\n### AI-Powered Penetration Testing Automation Platform\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n\n**Guardian** is an enterprise-grade AI-powered penetration testing automation framework that combines multiple AI providers (OpenAI GPT-4, Claude, Google Gemini, OpenRouter) with battle-tested security tools to deliver intelligent, adaptive security assessments with comprehensive evidence capture.\n\n[Features](#-features) • [Installation](#-installation) • [Quick Start](#-quick-start) • [Documentation](#-documentation) • [Contributing](#-contributing)\n\n\u003c/div\u003e\n\n---\n\n## ⚠️ Legal Disclaimer\n\n**Guardian is designed exclusively for authorized security testing and educational purposes.**\n\n- ✅ **Legal Use**: Authorized penetration testing, security research, educational environments\n- ❌ **Illegal Use**: Unauthorized access, malicious activities, any form of cyber attack\n\n**You are fully responsible for ensuring you have explicit written permission before testing any system.** Unauthorized access to computer systems is illegal under laws including the Computer Fraud and Abuse Act (CFAA), GDPR, and equivalent international legislation.\n\n**By using Guardian, you agree to use it only on systems you own or have explicit authorization to test.**\n\n---\n\n## ✨ Features\n\n### 🤖 Multi-Provider AI Intelligence\n\n- **4 AI Providers Supported**: OpenAI (GPT-4o), Anthropic (Claude), Google (Gemini), OpenRouter\n- **Flexible Provider Selection**: Switch between providers via config or command-line\n- **Multi-Agent Architecture**: Specialized AI agents (Planner, Tool Selector, Analyst, Reporter) collaborate for comprehensive security assessments\n- **Strategic Decision Making**: AI analyzes findings and determines optimal next steps\n- **Adaptive Testing**: AI adjusts tactics based on discovered vulnerabilities and system responses\n- **False Positive Filtering**: Intelligent analysis reduces noise and focuses on real vulnerabilities\n\n### 🛠️ Extensive Tool Arsenal\n\n**19 Integrated Security Tools:**\n- **Network**: Nmap (comprehensive scanning), Masscan (ultra-fast scanning)\n- **Web Reconnaissance**: httpx (HTTP probing), WhatWeb (tech fingerprinting), Wafw00f (WAF detection)\n- **Subdomain Discovery**: Subfinder (passive enumeration), Amass (active/passive mapping), DNSRecon (DNS analysis)\n- **Vulnerability Scanning**: Nuclei (template-based), Nikto (web vulnerabilities), SQLMap (SQL injection), WPScan (WordPress)\n- **SSL/TLS Testing**: TestSSL (cipher analysis), SSLyze (advanced configuration)\n- **Content Discovery**: Gobuster (directory brute forcing), FFuf (advanced web fuzzing), Arjun (parameter discovery)\n- **Security Analysis**: XSStrike (XSS detection), GitLeaks (secret scanning), CMSeeK (CMS detection)\n\n### 📊 Enhanced Evidence Capture\n\n- **Execution Traceability**: Every finding linked to its source tool execution\n- **Complete Command History**: Full tool output preserved with each finding\n- **Raw Evidence Storage**: 2000-character snippets of actual tool output\n- **Session Reconstruction**: Ability to review exact commands and outputs from any scan\n\n### 🔄 Smart Workflow System\n\n- **Parameter Priority**: Workflow parameters override config defaults\n- **Self-Contained Workflows**: Each workflow defines its own tool parameters\n- **Fuzzy Matching**: Intelligent workflow file discovery and loading\n- **Multiple Report Formats**: Markdown, HTML, and JSON with evidence inclusion\n\n### 🔒 Security \u0026 Compliance\n\n- **Scope Validation**: Automatic blacklisting of private networks and unauthorized targets\n- **Audit Logging**: Complete transparency with detailed logs of all AI decisions and actions\n- **Human-in-the-Loop**: Configurable confirmation prompts for sensitive operations\n- **Safe Mode**: Prevents destructive actions by default\n\n### 📋 Professional Reporting\n\n- **Multiple Formats**: Markdown, HTML, and JSON reports\n- **Executive Summaries**: Non-technical overviews for stakeholders\n- **Technical Deep-Dives**: Detailed findings with evidence and remediation steps\n- **Evidence Sections**: Raw tool output embedded in reports\n- **AI Decision Traces**: Full transparency into AI reasoning process\n\n### ⚡ Performance \u0026 Efficiency\n\n- **Asynchronous Execution**: Parallel tool execution for faster assessments\n- **Workflow Automation**: Predefined workflows (Recon, Web, Network, Autonomous)\n- **Customizable**: Create custom tools and workflows via simple YAML/Python\n\n---\n\n## 📋 Prerequisites\n\n### Required\n\n- **Python 3.11 or higher** ([Download](https://www.python.org/downloads/))\n- **AI Provider API Key** (Choose one):\n  - OpenAI API Key ([Get it here](https://platform.openai.com/api-keys))\n  - Anthropic API Key ([Get it here](https://console.anthropic.com/))\n  - Google AI Studio API Key ([Get it here](https://makersuite.google.com/app/apikey))\n  - OpenRouter API Key ([Get it here](https://openrouter.ai/keys))\n- **Git** (for cloning repository)\n\n### Optional Tools (for full functionality)\n\nGuardian can intelligently use these tools if installed:\n\n| Tool | Purpose | Installation |\n|------|---------|--------------|\n| **nmap** | Port scanning | `apt install nmap` / `choco install nmap` |\n| **masscan** | Ultra-fast scan | `apt install masscan` / Build from source |\n| **httpx** | HTTP probing | `go install github.com/projectdiscovery/httpx/cmd/httpx@latest` |\n| **subfinder** | Subdomain enum | `go install github.com/projectdiscovery/subfinder/v2/cmd/subfinder@latest` |\n| **amass** | Network mapping | `go install github.com/owasp-amass/amass/v4/...@master` |\n| **nuclei** | Vuln scanning | `go install github.com/projectdiscovery/nuclei/v3/cmd/nuclei@latest` |\n| **whatweb** | Tech fingerprint | `gem install whatweb` / `apt install whatweb` |\n| **wafw00f** | WAF detection | `pip install wafw00f` |\n| **nikto** | Web vuln scan | `apt install nikto` |\n| **sqlmap** | SQL injection | `pip install sqlmap` / `apt install sqlmap` |\n| **wpscan** | WordPress scan | `gem install wpscan` |\n| **testssl** | SSL/TLS testing | Download from [testssl.sh](https://testssl.sh/) |\n| **sslyze** | SSL/TLS analysis | `pip install sslyze` |\n| **gobuster** | Directory brute | `go install github.com/OJ/gobuster/v3@latest` |\n| **ffuf** | Web fuzzing | `go install github.com/ffuf/ffuf/v2@latest` |\n| **arjun** | Parameter discovery | `pip install arjun` |\n| **xsstrike** | Advanced XSS | `git clone https://github.com/s0md3v/XSStrike` |\n| **gitleaks** | Secret scanning | `go install github.com/zricethezav/gitleaks/v8@latest` |\n| **cmseek** | CMS detection | `pip install cmseek` |\n| **dnsrecon** | DNS enumeration | `pip install dnsrecon` |\n\n\u003e **Note**: Guardian works without external tools but with limited scanning capabilities. The AI will adapt based on available tools.\n\n---\n\n## 🚀 Installation\n\n### Step 1: Clone Repository\n\n```bash\ngit clone https://github.com/zakirkun/guardian-cli.git\ncd guardian-cli\n```\n\n### Step 2: Set Up Python Environment\n\n**Linux/macOS:**\n```bash\npython3 -m venv venv\nsource venv/bin/activate\npip install -e .\n```\n\n**Windows:**\n```powershell\npython -m venv venv\n.\\venv\\Scripts\\activate\npip install -e .\n```\n\n### Step 3: Configure AI Provider\n\nGuardian supports multiple AI providers. Configure your preferred provider in `config/guardian.yaml`:\n\n```yaml\n# config/guardian.yaml\nai:\n  # Choose your provider: openai, claude, gemini, or openrouter\n  provider: openai\n  \n  # OpenAI Configuration (recommended)\n  openai:\n    model: gpt-4o\n    api_key: sk-your-api-key-here  # Or set OPENAI_API_KEY env var\n  \n  # Claude Configuration\n  claude:\n    model: claude-3-5-sonnet-20241022\n    api_key: null  # Or set ANTHROPIC_API_KEY env var\n  \n  # Gemini Configuration\n  gemini:\n    model: gemini-2.5-pro\n    api_key: null  # Or set GOOGLE_API_KEY env var\n  \n  # OpenRouter Configuration\n  openrouter:\n    model: anthropic/claude-3.5-sonnet\n    api_key: null  # Or set OPENROUTER_API_KEY env var\n```\n\n**Or use environment variables:**\n\n```bash\n# Linux/macOS\nexport OPENAI_API_KEY=\"sk-your-key-here\"\nexport ANTHROPIC_API_KEY=\"sk-ant-your-key-here\"\nexport GOOGLE_API_KEY=\"your-gemini-key\"\nexport OPENROUTER_API_KEY=\"your-router-key\"\n\n# Windows PowerShell\n$env:OPENAI_API_KEY=\"sk-your-key-here\"\n$env:ANTHROPIC_API_KEY=\"sk-ant-your-key-here\"\n```\n\n### Step 4: Initialize Configuration\n\n```bash\n# Verify installation\npython -m cli.main --help\n\n# Check AI provider status\npython -m cli.main models\n```\n\n---\n\n## 🎯 Quick Start\n\n### Basic Commands\n\n```bash\n# List available workflows\npython -m cli.main workflow list\n\n# View AI providers and models\npython -m cli.main models\n\n# Run with specific provider\npython -m cli.main workflow run --name web_pentest --target example.com --provider openai\n```\n\n### Example Usage Scenarios\n\n#### 1. Quick Web Application Pen Test\n```bash\n# Fast security check with evidence capture\npython -m cli.main workflow run --name web_pentest --target https://dvwa.csalab.app\n```\n\n**Expected Output:**\n- ✅ HTTP discovery with httpx\n- ✅ Vulnerability scan with nuclei\n- ✅ Full evidence linking (commands + outputs)\n- ✅ Markdown report with findings\n\n#### 2. Comprehensive Network Assessment\n```bash\n# Full network penetration test\npython -m cli.main workflow run --name network --target 192.168.1.0/24\n```\n\n#### 3. Custom Workflow with Parameters\n```bash\n# Run with workflow-specific parameters\n# Parameters in workflow YAML override config defaults\npython -m cli.main workflow run --name web_pentest --target example.com\n```\n\n**Workflow Parameter Priority:**\n1. Workflow YAML parameters (highest priority)\n2. Config file parameters\n3. Tool defaults (lowest priority)\n\n#### 4. Generate Report from Session\n```bash\n# Create HTML report with evidence\npython -m cli.main report --session 20260203_175905 --format html\n```\n\n#### 5. Switch AI Providers\n```bash\n# Use OpenAI GPT-4\npython -m cli.main workflow run --name web_pentest --target example.com --provider openai\n\n# Use Claude\npython -m cli.main workflow run --name web_pentest --target example.com --provider claude\n\n# Use Gemini\npython -m cli.main workflow run --name web_pentest --target example.com --provider gemini\n```\n\n\u003e **Windows Users**: Use `python -m cli.main` instead of `guardian`\n\n---\n\n## 🔧 Configuration\n\n### Complete Configuration Reference\n\nEdit `config/guardian.yaml` to customize Guardian's behavior:\n\n```yaml\n# AI Configuration\nai:\n  provider: openai  # openai, claude, gemini, openrouter\n  \n  openai:\n    model: gpt-4o\n    api_key: sk-your-key  # Or use OPENAI_API_KEY env var\n  \n  claude:\n    model: claude-3-5-sonnet-20241022\n    api_key: null\n  \n  gemini:\n    model: gemini-2.5-pro\n    api_key: null\n  \n  temperature: 0.2\n  max_tokens: 8000\n\n# Penetration Testing Settings\npentest:\n  safe_mode: true              # Prevent destructive actions\n  require_confirmation: true   # Confirm before each step\n  max_parallel_tools: 3        # Concurrent tool execution\n  max_depth: 3                 # Maximum scan depth\n  tool_timeout: 300            # Tool timeout in seconds\n\n# Output Configuration\noutput:\n  format: markdown             # markdown, html, json\n  save_path: ./reports\n  include_reasoning: true\n  verbosity: normal            # quiet, normal, verbose, debug\n\n# Scope Validation\nscope:\n  blacklist:                   # Never scan these\n    - 127.0.0.0/8\n    - 10.0.0.0/8\n    - 172.16.0.0/12\n    - 192.168.0.0/16\n  require_scope_file: false\n  max_targets: 100\n\n# Tool Configuration (defaults)\ntools:\n  httpx:\n    threads: 50\n    timeout: 10\n    tech_detect: true\n  \n  nuclei:\n    severity: [\"critical\", \"high\", \"medium\"]\n    templates_path: ~/nuclei-templates\n  \n  nmap:\n    default_args: \"-sV -sC\"\n    timing: T4\n```\n\n### Workflow Parameters\n\nCreate custom workflows in `workflows/` directory:\n\n```yaml\n# workflows/custom_web.yaml\nname: custom_web_assessment\ndescription: Custom web security testing\n\nsteps:\n  - name: http_discovery\n    type: tool\n    tool: httpx\n    parameters:\n      threads: 100        # Override config default (50)\n      timeout: 15         # Override config default (10)\n      tech_detect: true\n  \n  - name: vulnerability_scan\n    type: tool\n    tool: nuclei\n    parameters:\n      severity: [\"critical\", \"high\"]  # Override config\n      templates_path: \".shared/nuclei/templates/\"\n  \n  - name: generate_report\n    type: report\n    # Format will use config default (markdown)\n```\n\n**Parameter Priority:**\n- Workflow parameters **override** config parameters\n- Config parameters **override** tool defaults\n- Self-contained, reusable workflows\n\n---\n\n## 📖 Documentation\n\n### User Guides\n- **[Quick Start Guide](QUICKSTART.md)** - Get up and running in 5 minutes\n- **[Command Reference](docs/)** - Detailed documentation for all commands\n- **[Configuration Guide](config/guardian.yaml)** - Complete configuration reference\n- **[Workflow Guide](docs/WORKFLOW_GUIDE.md)** - Creating custom workflows\n\n### Developer Guides\n- **[Creating Custom Tools](docs/TOOLS_DEVELOPMENT_GUIDE.md)** - Build your own tool integrations\n- **[Workflow Development](docs/WORKFLOW_GUIDE.md)** - Create custom testing workflows\n- **[Available Tools](tools/README.md)** - Overview of integrated tools\n\n### Architecture Overview\n\n```\nGuardian Architecture:\n┌─────────────────────────────────────────┐\n│         AI Provider Layer               │\n│  (OpenAI, Claude, Gemini, OpenRouter)   │\n└─────────────────────────────────────────┘\n                 │\n┌─────────────────────────────────────────┐\n│       Multi-Agent System                │\n│  Planner → Tool Agent → Analyst →      │\n│            Reporter                      │\n└─────────────────────────────────────────┘\n                 │\n┌─────────────────────────────────────────┐\n│      Workflow Engine                    │\n│  - Parameter Priority                   │\n│  - Evidence Capture                     │\n│  - Session Management                   │\n└─────────────────────────────────────────┘\n                 │\n┌─────────────────────────────────────────┐\n│      Tool Integration Layer             │\n│  (19 Security Tools)                    │\n└─────────────────────────────────────────┘\n```\n\n---\n\n## 🏗️ Project Structure\n\n```\nguardian-cli/\n├── ai/                    # AI integration\n│   └── providers/         # Multi-provider support\n│       ├── base_provider.py\n│       ├── openai_provider.py\n│       ├── claude_provider.py\n│       ├── gemini_provider.py\n│       └── openrouter_provider.py\n├── cli/                   # Command-line interface\n│   └── commands/         # CLI commands (init, scan, recon, etc.)\n├── core/                  # Core agent system\n│   ├── agent.py          # Base agent\n│   ├── planner.py        # Planner agent\n│   ├── tool_agent.py     # Tool selection agent\n│   ├── analyst_agent.py  # Analysis agent\n│   ├── reporter_agent.py # Reporting agent\n│   ├── memory.py         # State management\n│   └── workflow.py       # Workflow orchestration\n├── tools/                 # Pentesting tool wrappers\n│   ├── nmap.py           # Nmap integration\n│   ├── masscan.py        # Masscan integration\n│   ├── httpx.py          # httpx integration\n│   ├── subfinder.py      # Subfinder integration\n│   ├── amass.py          # Amass integration\n│   ├── nuclei.py         # Nuclei integration\n│   ├── sqlmap.py         # SQLMap integration\n│   ├── wpscan.py         # WPScan integration\n│   ├── whatweb.py        # WhatWeb integration\n│   ├── wafw00f.py        # Wafw00f integration\n│   ├── nikto.py          # Nikto integration\n│   ├── testssl.py        # TestSSL integration\n│   ├── sslyze.py         # SSLyze integration\n│   ├── gobuster.py       # Gobuster integration\n│   ├── ffuf.py           # FFuf integration\n│   └── ...               # 15 tools total\n├── workflows/             # Workflow definitions (YAML)\n├── utils/                 # Utilities (logging, validation)\n├── config/                # Configuration files\n├── docs/                  # Documentation\n└── reports/               # Generated reports\n```\n\n---\n\n## 🆕 Latest Updates\n\n### Version 2.0.0 - Major Release\n\n#### ✨ Multi-Provider AI Support\n- **4 AI Providers**: OpenAI, Claude, Gemini, OpenRouter\n- **Easy Switching**: Configure via `config/guardian.yaml` or CLI flags\n- **Provider Abstraction**: Unified interface for all providers\n\n#### 📊 Evidence Capture System\n- **Execution Linking**: Every finding linked to its source tool execution\n- **Raw Evidence**: Full command output preserved (2000-char snippets)\n- **Traceability**: Reconstruct exact workflow execution from session files\n\n#### 🔄 Smart Workflow Parameters\n- **Priority System**: Workflow params \u003e Config \u003e Defaults\n- **Self-Contained**: Workflows define their own parameters\n- **No Conflicts**: Multiple workflows can use different settings for same tools\n\n#### 🐛 Bug Fixes\n- Fixed workflow fuzzy matching logic\n- Corrected report format handling\n- Improved YAML parsing with better error messages\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions! Here's how:\n\n### Setting Up Development Environment\n\n```bash\n# Fork and clone\ngit clone https://github.com/zakirkun/guardian-cli.git\ncd guardian-cli\n\n# Install dev dependencies\npip install -e \".[dev]\"\n\n# Run tests\npytest tests/\n\n# Format code\nblack .\n```\n\n### Contribution Areas\n\n- 🤖 **AI Provider Integrations** - Add more AI models\n- 🛠️ **New Tool Integrations** - Add more security tools\n- 🔄 **Custom Workflows** - Share your workflow templates\n- 🐛 **Bug Fixes** - Report and fix issues\n- 📚 **Documentation** - Improve guides and examples\n- 🧪 **Testing** - Expand test coverage\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.\n\n---\n\n## 📊 Roadmap\n\n- [x] Multi-provider AI support (OpenAI, Claude, Gemini, OpenRouter)\n- [x] Complete evidence capture with execution linking\n- [x] Workflow parameter priority system\n- [ ] Web Dashboard for visualization\n- [ ] PostgreSQL backend for multi-session tracking\n- [ ] MITRE ATT\u0026CK mapping for findings\n- [ ] Plugin system for custom modules\n- [ ] Integration with CI/CD pipelines\n- [ ] Additional AI models (Llama, Mistral)\n- [ ] Real-time collaboration features\n\n---\n\n## 🐛 Troubleshooting\n\n### Common Issues\n\n**Import Errors**\n```bash\n# Reinstall dependencies\npip install -e . --force-reinstall\n```\n\n**AI Provider Errors**\n```bash\n# Verify API key is set\npython -m cli.main models\n\n# Check provider configuration\ncat config/guardian.yaml | grep -A 5 \"ai:\"\n```\n\n**Tool Not Found**\n```bash\n# Check tool availability\nwhich nmap\nwhich httpx\n\n# Install missing tools (see Prerequisites)\n```\n\n**Workflow Not Loading**\n```bash\n# Check workflow file exists\nls workflows/web_pentest.yaml\n\n# Verify YAML syntax\npython -c \"import yaml; yaml.safe_load(open('workflows/web_pentest.yaml'))\"\n```\n\n**Windows Command Not Found**\n```powershell\n# Use full command\npython -m cli.main --help\n```\n\nFor more help, [open an issue](https://github.com/zakirkun/guardian-cli/issues).\n\n---\n\n## 📄 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n---\n\n## 🙏 Acknowledgments\n\n- **OpenAI** - GPT-4 capabilities\n- **Anthropic** - Claude AI\n- **Google** - Gemini AI\n- **LangChain** - AI orchestration framework\n- **ProjectDiscovery** - Open-source security tools (httpx, subfinder, nuclei)\n- **Nmap** - Network exploration and security auditing\n- **The Security Community** - Tool developers and researchers\n\n---\n\n## 📞 Support \u0026 Contact\n\n- **GitHub Issues**: [Report bugs or request features](https://github.com/zakirkun/guardian-cli/issues)\n- **Discussions**: [Join community discussions](https://github.com/zakirkun/guardian-cli/discussions)\n- **Documentation**: [Read the docs](docs/)\n- **Security**: Report vulnerabilities privately to security@example.com\n\n---\n\n## 🌟 Star History\n\n\u003ca href=\"https://github.com/zakirkun/guardian-cli/stargazers\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=zakirkun/guardian-cli\u0026type=Date\u0026theme=dark\" /\u003e\n    \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=zakirkun/guardian-cli\u0026type=Date\" /\u003e\n    \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=zakirkun/guardian-cli\u0026type=Date\" /\u003e\n  \u003c/picture\u003e\n\u003c/a\u003e\n\n---\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Guardian** - Intelligent, Ethical, Automated Penetration Testing\n\nMade with ❤️ by the Security Community\n\n[⬆ Back to Top](#-guardian)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzakirkun%2Fguardian-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzakirkun%2Fguardian-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzakirkun%2Fguardian-cli/lists"}