Secbot (Python)

Secbot is an AI-powered security automation CLI for authorized security testing, research, and education.

Security notice: use this tool only in environments where you have explicit authorization. Unauthorized scanning, exploitation, and control actions may violate laws or regulations.

Why This Package

• CLI-first workflow built on Typer + Rich, with one-shot and interactive operation.
• Optional FastAPI server mode for REST/SSE integration in automation pipelines.
• Multi-agent execution flow (secbot-cli and superhackbot) for plan, execute, and summarize loops.
• Security toolchain covering network, web, OSINT, defense scan, reporting, and system utilities.
• Multi-provider LLM backends including Ollama, DeepSeek, OpenAI-compatible APIs, and more.

Requirements

• Python >= 3.10
• pip (or uv)
• Optional: Ollama for local models

Install

Install from PyPI (recommended)

pip install secbot

If you want beta/pre-release versions:

pip install --pre secbot

Install with uv

uv pip install secbot

Install from source

git clone https://github.com/iammm0/secbot.git
cd secbot
uv sync
uv pip install -e .

Quick Start

1. Configure environment variables

Create a .env file in your working directory:

# Cloud model backend (recommended)
LLM_PROVIDER=deepseek
DEEPSEEK_API_KEY=sk-your-api-key
DEEPSEEK_MODEL=deepseek-reasoner

# Optional local backend (Ollama)
# LLM_PROVIDER=ollama
# OLLAMA_BASE_URL=http://localhost:11434
# OLLAMA_MODEL=gemma3:1b
# OLLAMA_EMBEDDING_MODEL=nomic-embed-text

2. Run the CLI

# Interactive mode
secbot

# One-shot task
secbot "扫描 192.168.1.1 的开放端口"

# Q&A mode
secbot --ask "什么是 XSS 攻击？"

# Expert agent
secbot --agent superhackbot

# Switch backend/model
secbot model

3. Start API server (optional)

secbot server

CLI Commands

Common Environment Variables

Documentation

• Quickstart
• API Reference
• LLM Providers
• Ollama Setup
• Deployment
• Release Guide
• Database Guide
• Security Warning

Project Links

• Homepage: https://github.com/iammm0/secbot
• Issue Tracker: https://github.com/iammm0/secbot/issues
• Releases: https://github.com/iammm0/secbot/releases
• PyPI: https://pypi.org/project/secbot/

License

This project is licensed under MIT. See LICENSE for details.