Metadata-Version: 2.4
Name: fastband-agent-control
Version: 1.2026.1.3
Summary: Fastband Agent Control - Universal platform for AI agent coordination, multi-agent orchestration, and autonomous development workflows
Project-URL: Homepage, https://github.com/RemmyCH3CK/fastband-mcp
Project-URL: Documentation, https://github.com/RemmyCH3CK/fastband-mcp#readme
Project-URL: Repository, https://github.com/RemmyCH3CK/fastband-mcp
Project-URL: Issues, https://github.com/RemmyCH3CK/fastband-mcp/issues
Author: Fastband Team
License-Expression: MIT
License-File: LICENSE
Keywords: agent-control,ai,ai-agents,automation,claude,development,gemini,mcp,multi-agent,openai,orchestration
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Quality Assurance
Requires-Python: >=3.10
Requires-Dist: aiofiles>=23.0.0
Requires-Dist: fastapi>=0.100.0
Requires-Dist: httpx>=0.25.0
Requires-Dist: mcp>=0.9.0
Requires-Dist: numpy>=1.24.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.0.0
Requires-Dist: typer>=0.9.0
Requires-Dist: uvicorn>=0.23.0
Requires-Dist: websockets>=11.0.0
Provides-Extra: all-providers
Requires-Dist: anthropic>=0.18.0; extra == 'all-providers'
Requires-Dist: google-generativeai>=0.3.0; extra == 'all-providers'
Requires-Dist: ollama>=0.1.0; extra == 'all-providers'
Requires-Dist: openai>=1.0.0; extra == 'all-providers'
Provides-Extra: auth
Requires-Dist: keyring>=24.0.0; extra == 'auth'
Requires-Dist: pyjwt>=2.8.0; extra == 'auth'
Provides-Extra: claude
Requires-Dist: anthropic>=0.18.0; extra == 'claude'
Provides-Extra: cloud
Requires-Dist: supabase>=2.0.0; extra == 'cloud'
Provides-Extra: dev
Requires-Dist: flask>=2.0.0; extra == 'dev'
Requires-Dist: mypy>=1.5.0; extra == 'dev'
Requires-Dist: numpy>=1.24.0; extra == 'dev'
Requires-Dist: pre-commit>=3.0.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Provides-Extra: full
Requires-Dist: alembic>=1.13.0; extra == 'full'
Requires-Dist: anthropic>=0.18.0; extra == 'full'
Requires-Dist: fastapi>=0.100.0; extra == 'full'
Requires-Dist: flask>=2.0.0; extra == 'full'
Requires-Dist: google-generativeai>=0.3.0; extra == 'full'
Requires-Dist: jinja2>=3.0.0; extra == 'full'
Requires-Dist: keyring>=24.0.0; extra == 'full'
Requires-Dist: mypy>=1.5.0; extra == 'full'
Requires-Dist: numpy>=1.24.0; extra == 'full'
Requires-Dist: ollama>=0.1.0; extra == 'full'
Requires-Dist: openai>=1.0.0; extra == 'full'
Requires-Dist: opentelemetry-api>=1.20.0; extra == 'full'
Requires-Dist: opentelemetry-exporter-otlp>=1.20.0; extra == 'full'
Requires-Dist: opentelemetry-instrumentation-fastapi>=0.41b0; extra == 'full'
Requires-Dist: opentelemetry-instrumentation-httpx>=0.41b0; extra == 'full'
Requires-Dist: opentelemetry-sdk>=1.20.0; extra == 'full'
Requires-Dist: pillow>=10.0.0; extra == 'full'
Requires-Dist: playwright>=1.40.0; extra == 'full'
Requires-Dist: pre-commit>=3.0.0; extra == 'full'
Requires-Dist: psutil>=5.9.0; extra == 'full'
Requires-Dist: psycopg2-binary>=2.9.0; extra == 'full'
Requires-Dist: pyjwt>=2.8.0; extra == 'full'
Requires-Dist: pymysql>=1.1.0; extra == 'full'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'full'
Requires-Dist: pytest-cov>=4.0.0; extra == 'full'
Requires-Dist: pytest>=7.0.0; extra == 'full'
Requires-Dist: redis>=5.0.0; extra == 'full'
Requires-Dist: ruff>=0.1.0; extra == 'full'
Requires-Dist: supabase>=2.0.0; extra == 'full'
Requires-Dist: uvicorn>=0.23.0; extra == 'full'
Requires-Dist: websockets>=11.0.0; extra == 'full'
Provides-Extra: gemini
Requires-Dist: google-generativeai>=0.3.0; extra == 'gemini'
Provides-Extra: migrations
Requires-Dist: alembic>=1.13.0; extra == 'migrations'
Provides-Extra: mysql
Requires-Dist: pymysql>=1.1.0; extra == 'mysql'
Provides-Extra: ollama
Requires-Dist: ollama>=0.1.0; extra == 'ollama'
Provides-Extra: openai
Requires-Dist: openai>=1.0.0; extra == 'openai'
Provides-Extra: postgres
Requires-Dist: psycopg2-binary>=2.9.0; extra == 'postgres'
Provides-Extra: redis
Requires-Dist: redis>=5.0.0; extra == 'redis'
Provides-Extra: screenshots
Requires-Dist: pillow>=10.0.0; extra == 'screenshots'
Requires-Dist: playwright>=1.40.0; extra == 'screenshots'
Provides-Extra: system
Requires-Dist: psutil>=5.9.0; extra == 'system'
Provides-Extra: tracing
Requires-Dist: opentelemetry-api>=1.20.0; extra == 'tracing'
Requires-Dist: opentelemetry-exporter-otlp>=1.20.0; extra == 'tracing'
Requires-Dist: opentelemetry-instrumentation-fastapi>=0.41b0; extra == 'tracing'
Requires-Dist: opentelemetry-instrumentation-httpx>=0.41b0; extra == 'tracing'
Requires-Dist: opentelemetry-sdk>=1.20.0; extra == 'tracing'
Provides-Extra: web
Requires-Dist: fastapi>=0.100.0; extra == 'web'
Requires-Dist: jinja2>=3.0.0; extra == 'web'
Requires-Dist: uvicorn>=0.23.0; extra == 'web'
Requires-Dist: websockets>=11.0.0; extra == 'web'
Description-Content-Type: text/markdown

# Fastband Agent Control

**Universal platform for AI agent coordination** - Multi-agent orchestration, autonomous development workflows, and adaptive tools with ticket management.

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![Version](https://img.shields.io/badge/version-v1.2026.01.03-green.svg)](https://github.com/RemmyCH3CK/fastband-mcp/releases)

---

## Vision

> **"A toolbox that travels with you - always the right tools, never too many, ready to grow."**

Fastband Agent Control transforms AI-assisted development from a project-specific setup into a **universal platform** that:

- Works with **any AI provider** (Claude, OpenAI, Gemini, local LLMs)
- Adapts to **any project type** (web, mobile, desktop, API)
- Scales from **solo developers to enterprise teams**
- Provides **intelligent tool recommendations** based on your project
- Includes **built-in ticket management** that adapts to your workflow
- Enables **multi-agent coordination** for parallel AI workflows

---

## Features

### AI-Agnostic Design
```python
# Switch between providers seamlessly
from fastband import get_provider

claude = get_provider("claude")
openai = get_provider("openai")
local = get_provider("ollama")
```

### Tool Garage System
- **Core tools** always available
- **AI-recommended** tools based on your project
- **Dynamic loading** - add tools as your project grows
- **Performance monitoring** to prevent overload

### Adaptive Ticket Manager
| Project Type | Interface |
|--------------|-----------|
| Web App | CLI + Web Dashboard |
| Desktop App | Embedded Panel (Ctrl+Shift+T) |
| Mobile App | CLI + Companion Web |
| API/Library | CLI only |

### Multi-Agent Coordination
- **Clearance system** for parallel work
- **Hold directives** for critical operations
- **Rebuild announcements** to prevent conflicts

### Automated Backups
- **Change detection** - only backup when needed
- **Multiple database support** - SQLite, PostgreSQL, MySQL
- **Configurable retention** policies

### Webhooks
- **External notifications** for ticket and agent events
- **HMAC signatures** (SHA-256) for secure verification
- **Automatic retries** with exponential backoff
- **CLI management** via `fastband webhooks`

```bash
# Create a webhook for ticket events
fastband webhooks create https://api.slack.com/webhook \
  -e ticket.completed -e ticket.claimed \
  -n "Slack Notifications"

# Test the webhook
fastband webhooks test <webhook-id>
```

### Enterprise Features

| Feature | Description |
|---------|-------------|
| **API Versioning** | `/api/v1/` prefix with deprecation headers |
| **JWT Authentication** | Role-based access control with FastAPI |
| **OpenTelemetry** | Distributed tracing (OTLP/Jaeger/Zipkin) |
| **Circuit Breakers** | Resilience for AI provider failures |
| **Redis Sessions** | Horizontal scaling support |
| **Database Migrations** | Alembic schema versioning |

---

## Quick Start

### Installation

```bash
# Standard installation (includes CLI + Hub dashboard)
pip install fastband-agent-control

# With Claude support
pip install fastband-agent-control[claude]

# With all AI providers
pip install fastband-agent-control[all-providers]

# Full installation (all features + dev tools)
pip install fastband-agent-control[full]
```

### Initialize a Project

```bash
cd /your/project
fastband init
```

This launches the setup wizard that will:
1. Detect your project type
2. Recommend AI provider
3. Configure GitHub integration
4. Select appropriate tools
5. Set up ticket management
6. Configure backups

### Basic Commands

```bash
# Check status
fastband status

# List available tools
fastband tools list

# Manage tickets
fastband tickets list
fastband tickets create "Add user authentication"
fastband tickets claim 1 --agent "MCP_Agent1"

# Backup management
fastband backup list
fastband backup create --name "before_refactor"

# Agent coordination
fastband agents status
fastband ops read --since 1h

# Webhook management
fastband webhooks list
fastband webhooks create URL -e ticket.completed
fastband webhooks test <id>
```

---

## Configuration

Fastband stores configuration in `.fastband/config.yaml`:

```yaml
fastband:
  version: "1.2025.12"

  ai:
    default_provider: "claude"
    providers:
      claude:
        model: "claude-sonnet-4-20250514"
      openai:
        model: "gpt-4-turbo"

  tools:
    max_active: 60
    auto_load_core: true

  tickets:
    enabled: true
    mode: "cli_web"
    web_port: 5050

  backup:
    enabled: true
    daily_retention: 7
    weekly_retention: 4
```

---

## Documentation

- [Getting Started](docs/getting-started/quickstart.md)
- [AI Providers Guide](docs/guides/ai-providers.md)
- [Tool Garage](docs/guides/tool-garage.md)
- [Ticket Manager](docs/guides/ticket-manager.md)
- [Multi-Agent Coordination](docs/guides/coordination.md)
- [API Reference](docs/api/)

---

## Roadmap

### v1.2026.01.03 (Current - Stable)
- [x] Core MCP server
- [x] AI provider abstraction
- [x] Tool garage system
- [x] Setup wizard
- [x] Full ticket manager with web UI
- [x] Control Plane dashboard
- [x] Plugin system
- [x] Vision analysis tools
- [x] **Enterprise hardening** (JWT, tracing, circuit breakers)
- [x] **Webhooks** for external event notifications
- [x] **API versioning** with deprecation support
- [x] **Redis session store** for horizontal scaling

### v1.2026.02.0 (Next)
- [ ] Enhanced multi-agent workflows
- [ ] E2E testing integration
- [ ] Visual regression testing
- [ ] Slack/Discord webhook integrations
- [ ] Prometheus metrics endpoint

---

## Contributing

We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.

### Development Setup

```bash
git clone https://github.com/RemmyCH3CK/fastband-mcp
cd fastband-mcp
pip install -e ".[dev]"
pre-commit install
pytest
```

---

## License

MIT License - see [LICENSE](LICENSE) for details.

---

## Acknowledgments

Fastband Agent Control evolved from the MLB v4.0.1 development platform, incorporating lessons learned from building production AI-assisted development workflows.
