A sophisticated orchestration system that manages multiple AI coding agents working on software development tasks. The system leverages Aider (an AI coding assistant) to handle coding tasks and provides a real-time web interface for monitoring and managing these agents.
- Multi-Agent Task Handling: Deploy multiple AI agents to work on coding tasks simultaneously with isolated workspaces
- Git Integration: Automatic repository cloning and branch management per agent
- Real-Time Progress Monitoring: Track agent progress and status through WebSocket updates
- Workspace Isolation: Each agent works in an isolated workspace to prevent conflicts
- Configuration Management: Flexible configuration system for repository URLs and task management
- Web-Based Control Interface: User-friendly web interface with real-time updates and keyboard shortcuts
- Automated Code Critiquing: Built-in system for evaluating agent progress and code quality
- Session Management: Robust handling of agent sessions with error recovery
- Health Monitoring: Continuous monitoring of agent health with automatic error detection
- Debug Tools: Comprehensive debugging endpoints for troubleshooting
- Core component managing AI coding agents
- Handles workspace creation and git repository management
- Monitors agent progress with health checks
- Maintains agent sessions and outputs via WebSocket
- Integrates with Aider for code generation
- Implements error recovery and retry mechanisms
- Provides detailed agent diagnostics
- Manages system configuration and environment setup
- Handles repository URLs and task tracking
- Controls agent count per task
- Persists configuration in JSON format
- Normalizes file paths across operating systems
- Flask-based web application with WebSocket support
- Real-time agent creation and management interface
- Live status and progress display
- Task assignment and monitoring
- Agent deletion and cleanup functionality
- Toast notifications for important events
- Keyboard shortcuts for common operations
- Debug endpoints for troubleshooting
- Clone the repository:
git clone https://github.com/yourusername/100x-orchestrator.git
cd 100x-orchestrator- Create and activate a virtual environment:
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate- Install dependencies:
pip install -r requirements.txt- Create a
config.jsonfile in the root directory:
{
"repository_url": "",
"tasks": [],
"agents": {},
"current_task_index": 0,
"default_agents_per_task": 1
}- Set up your environment variables:
export LITELLM_MODEL=anthropic/claude-3-5-sonnet-20240620 # Or your preferred model- Start the web server:
python app.py-
Access the web interface at
http://localhost:5000 -
Create new agents:
- Provide a repository URL
- Define tasks
- Set the number of agents per task
- Click "Create Agent"
-
Monitor progress:
- View agent status in the web interface
- Check agent outputs and critiques
- Manage agent lifecycle
100x-orchestrator/
├── app.py # Web interface
├── orchestrator.py # Core orchestration logic
├── config.py # Configuration management
├── requirements.txt # Project dependencies
├── tasks/ # Task storage
├── templates/ # Web interface templates
└── workspaces/ # Agent workspaces
- Python
- Flask
- Flask-SocketIO
- Aider
- Git
- JSON for configuration
- Threading for concurrent operations
- WebSocket for real-time updates
- Bootstrap for UI
- Font Awesome for icons
- Fork the repository
- Create a feature branch
- Commit your changes
- Push to the branch
- Create a Pull Request