Metadata-Version: 2.4
Name: superagent-cli
Version: 2.8.0
Summary: AI Agent self-organizing teams, task allocation, and collaborative CLI tool. 49 commands, 16 integrated open-source projects, 178 role templates.
Project-URL: Homepage, https://github.com/superagent-cli/superagent
Project-URL: Repository, https://github.com/superagent-cli/superagent
Project-URL: Documentation, https://github.com/superagent-cli/superagent/blob/main/docs/USAGE.md
Project-URL: Changelog, https://github.com/superagent-cli/superagent/blob/main/CHANGELOG.md
Author: SuperAgent Contributors
License: MIT
License-File: LICENSE
Keywords: agent,ai,automation,cli,coordination,llm,multi-agent,superagent,swarm,team
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Requires-Python: >=3.10
Requires-Dist: httpx>=0.24.0
Requires-Dist: pydantic<3.0.0,>=2.0.0
Requires-Dist: rich<15.0.0,>=13.0.0
Requires-Dist: tomli>=2.0.0; python_version < '3.11'
Requires-Dist: typer<1.0.0,>=0.12.0
Provides-Extra: all
Requires-Dist: aider-chat>=0.80.0; extra == 'all'
Requires-Dist: browser-use>=0.10.0; extra == 'all'
Requires-Dist: composio-core>=0.7.0; extra == 'all'
Requires-Dist: e2b>=2.0.0; extra == 'all'
Requires-Dist: fastapi>=0.110.0; extra == 'all'
Requires-Dist: firecrawl-py>=1.0.0; extra == 'all'
Requires-Dist: flask>=3.0.0; extra == 'all'
Requires-Dist: langfuse>=3.0.0; extra == 'all'
Requires-Dist: litellm>=1.0.0; extra == 'all'
Requires-Dist: mcp>=1.0.0; extra == 'all'
Requires-Dist: mem0ai>=1.0.0; extra == 'all'
Requires-Dist: passlib[bcrypt]>=1.7.4; extra == 'all'
Requires-Dist: pillow>=10.0.0; extra == 'all'
Requires-Dist: playwright>=1.40.0; extra == 'all'
Requires-Dist: python-frontmatter>=1.0.0; extra == 'all'
Requires-Dist: python-jose[cryptography]>=3.3.0; extra == 'all'
Requires-Dist: uvicorn[standard]>=0.29.0; extra == 'all'
Provides-Extra: browser
Requires-Dist: browser-use>=0.10.0; extra == 'browser'
Provides-Extra: coding
Requires-Dist: aider-chat>=0.80.0; extra == 'coding'
Provides-Extra: dashboard
Requires-Dist: flask>=3.0.0; extra == 'dashboard'
Requires-Dist: pillow>=10.0.0; extra == 'dashboard'
Provides-Extra: dev
Requires-Dist: build; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Requires-Dist: twine; extra == 'dev'
Provides-Extra: gateway
Requires-Dist: fastapi>=0.110.0; extra == 'gateway'
Requires-Dist: passlib[bcrypt]>=1.7.4; extra == 'gateway'
Requires-Dist: python-jose[cryptography]>=3.3.0; extra == 'gateway'
Requires-Dist: uvicorn[standard]>=0.29.0; extra == 'gateway'
Provides-Extra: llm
Requires-Dist: litellm>=1.0.0; extra == 'llm'
Provides-Extra: mcp
Requires-Dist: mcp>=1.0.0; extra == 'mcp'
Provides-Extra: memory
Requires-Dist: mem0ai>=1.0.0; extra == 'memory'
Provides-Extra: p2p
Requires-Dist: pyzmq<27.0.0,>=25.0.0; extra == 'p2p'
Provides-Extra: publish
Requires-Dist: playwright>=1.40.0; extra == 'publish'
Requires-Dist: python-frontmatter>=1.0.0; extra == 'publish'
Provides-Extra: sandbox
Requires-Dist: e2b>=2.0.0; extra == 'sandbox'
Provides-Extra: scraping
Requires-Dist: firecrawl-py>=1.0.0; extra == 'scraping'
Provides-Extra: services
Requires-Dist: composio-core>=0.7.0; extra == 'services'
Provides-Extra: tracing
Requires-Dist: langfuse>=3.0.0; extra == 'tracing'
Description-Content-Type: text/markdown

<p align="center">
  <img src="docs/logo.svg" alt="SuperAgent Logo" width="120">
</p>

<h1 align="center">SuperAgent</h1>

[![CI](https://github.com/superagent-cli/superagent/actions/workflows/ci.yml/badge.svg)](https://github.com/superagent-cli/superagent/actions/workflows/ci.yml)
[![PyPI version](https://img.shields.io/pypi/v/superagent-cli)](https://pypi.org/project/superagent-cli/)
[![Python 3.10+](https://img.shields.io/pypi/pyversions/superagent-cli)](https://pypi.org/project/superagent-cli/)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)

AI Agent self-organizing teams, task allocation, and collaborative CLI tool.

> One command → agents form teams, split tasks, coordinate work, deliver results.

## Highlights

- **49 CLI commands** covering the full agent lifecycle
- **16 open-source projects integrated** (577k+ total GitHub stars)
- **178 professional agent roles** across 14 departments
- **4 execution engines**: DeerFlow, Aider, Browser-use, GPT-Researcher
- **Zero-cost offline mode**: Ollama / LocalAI / llama.cpp
- **Pixel-art dashboard**: Real-time agent visualization

## Quick Start

```bash
pip install superagent-cli
superagent auto "Build a todo app with auth" --command builtin
```

## Core Commands

| Command | Description |
|---------|-------------|
| `superagent auto "goal"` | One sentence → full team automation |
| `superagent auto "goal" --command local` | Zero-cost offline execution |
| `superagent role match "task"` | Smart role matching from 178 templates |
| `superagent triage route "task"` | Intelligent routing to best agent |
| `superagent engine list` | Show available execution engines |
| `superagent pipeline show sdlc` | View SOP workflow |
| `superagent dashboard serve --team X` | Pixel-art visualization |
| `superagent trends search "topic"` | Multi-platform trend search |
| `superagent browser run "task"` | Web automation |
| `superagent research run "query"` | Deep research |

## Integrated Projects (577k+ Stars)

| Project | Stars | Capability |
|---------|-------|-----------|
| Browser-use | 86k | Web automation |
| agency-agents | 76k | 178 role templates |
| DeerFlow | 60k | LLM execution engine |
| Mem0 | 52k | Semantic memory |
| Firecrawl | 91k | Web scraping |
| RAGFlow | 75k | Document RAG |
| Aider | 25k | Coding agent |
| GPT-Researcher | 18k | Deep research |
| Composio | 12k | 200+ service integrations |
| E2B | 7k | Sandbox execution |
| Star-Office-UI | 7k | Pixel-art dashboard |
| ClawTeam | 5k | Team coordination base |
| LocalAI support | 45k | Zero-cost local models |
| Langfuse | OSS | Execution tracing |
| Hermes Agent | 47k | Learning patterns (design) |
| ClawTeam-OpenClaw | 1k | Enhanced features |

## Architecture

```
User → superagent auto "goal"
  → Orchestrator (category detect + role match)
  → Execution Engine (DeerFlow / Aider / Local)
  → Multi-Agent (each in Git Worktree + tmux)
  → File Output + Dashboard Visualization
```

## Installation

```bash
pip install superagent-cli          # Core
pip install superagent-cli[all]      # Everything
```

### Install from Source (development)

```bash
git clone https://github.com/superagent-cli/superagent.git
cd superagent
pip install -e .           # Core
pip install -e ".[dashboard]"  # + Dashboard
```

### Optional: Local Model (zero cost)
```bash
brew install ollama && ollama serve &
ollama pull llama3.2
superagent local register
superagent auto "Build X" --command local
```

## Configuration

```bash
# LLM Provider (pick one)
superagent llm add --name deepseek --api-key $DEEPSEEK_API_KEY --base-url https://api.deepseek.com/v1 --model deepseek-chat
superagent llm default deepseek

# Or use local models (free)
superagent local setup --model llama3.2
```

## Documentation

- [Usage Guide](docs/USAGE.md) — Complete 10-section tutorial
- [Evaluation Report](EVALUATION.md) — 5W2H1R + SWOT analysis

## License

MIT
