Unified multi-agent system built on LangGraph that provides both direct interaction with specialized AI agents and autonomous task delegation to a coordinated team of agents.
- Dual Operation Modes: Direct agent interaction and autonomous orchestration
- Multi-Model Support: OpenAI, Anthropic Claude, and Google Gemini
- Specialized Agents: Full Stack Engineer, QA Engineer, Product Designer, DevOps Engineer
- Multimodal Processing: Support for images, PDFs, and design documents
- Multiple Interfaces: Web UI and Slack integration
- Extensible Architecture: Built on LangGraph with MCP tool integration
- Python 3.11+
- uv (Python package manager)
- Redis (for state management)
- Clone the repository:
git clone <repository-url> cd agent-hive
- Quick setup (recommended):
make setup
This will:
- Copy
.env.exampleto.env - Install all dependencies
- Start Redis using Docker
- Run verification checks
- Manual setup:
# Install dependencies make dev-install # Copy environment configuration make setup-env # Configure your API keys in .env # Edit .env with your API keys OPENAI_API_KEY=your_key_here ANTHROPIC_API_KEY=your_key_here GOOGLE_API_KEY=your_key_here # Start Redis make redis-start # Verify setup make verify
- Run the application:
make run
The API will be available at http://localhost:8000
- Interactive API docs:
http://localhost:8000/docs - Health check:
http://localhost:8000/health - System status:
http://localhost:8000/status
Run make help to see all available commands:
make helpCommon development commands:
make dev-install # Install development dependencies make test # Run test suite make lint # Run linting checks make format # Format code make run # Start the server make health # Check server health make redis-start # Start Redis make verify # Verify setup
agent_hive/
├── agent_hive/
│ ├── core/ # Core data structures and configuration
│ ├── agents/ # Agent implementations
│ ├── api/ # FastAPI application and routing
│ ├── integrations/ # External service integrations
│ └── utils/ # Utility functions
├── tests/ # Test suite
├── main.py # Application entry point
├── Makefile # Development commands
└── pyproject.toml # Project configuration
# Format and check code make dev # Run tests with coverage make test-coverage # Check production readiness make prod-check
[Add your license here]