How aj47/100x-orchestrator works
High-Level System Components
a) Web Interface Layer
• Static/templates components
• REST API endpoints
b) Orchestration Layer (Core)
• Central orchestrator component
• Agent session management
• Database system
• LiteLLM client integration
c) Execution Layer
• Aider agents
• Individual workspaces
• Git integration
Component Relationships
[Web Interface Layer]
• HTTP/WebSocket
[Orchestration Layer]
• Process Management
[Execution Layer]
Detailed Component Breakdown
┌─────────────────────────────────────────┐
• Web Interface │
• ┌─────────┐ ┌─────────┐ ┌─────────┐ │
• Index │ │Agent │ │Config │ │
• View │ │View │ │View │ │
• ┘ └─────────┘ └─────────┘ │
• ┬─────────────────────┘
┌───────────────────┼─────────────────────┐
• Orchestration Layer │
• ┌─────────┐ ┌─────────┐ ┌─────────┐ │
• Orchestra│ │Agent │ │Prompt │ │
• tor │ │Session │ │Processor│ │
• ┬────┘ └────┬────┘ └────┬────┘ │
• ┌────┴────┐ ┌────┴────┐ ┌────┴────┐ │
• Database │ │LiteLLM │ │GitHub │ │
• Client │ │Integration│ │
• ┘ └─────────┘ └─────────┘ │
• ┬─────────────────────┘
┌───────────────────┼─────────────────────┐
• Execution Layer │
• ┌─────────┐ ┌─────────┐ ┌─────────┐ │
• Aider │ │Git │ │Workspace│ │
• Instances│ │Repos │ │Manager │ │
• ┘ └─────────┘ └─────────┘ │
• ┘
Data Flow Indicators
• User requests flow (Web → Orchestrator)
• Agent creation and management flow (Orchestrator → Execution)
• Database operations (Components ↔ Database)
• API calls (Components ↔ External Services)
Important Elements
• Database schema representation (tasks.db)
• API endpoints from app.py
• Environment configuration flow
• Testing infrastructure (pytest)
• Security components (GitHub token handling)
Configuration and state management
Remember to maintain a balance between detail and clarity, focusing on the architectural decisions that make this system unique, particularly its AI agent orchestration capabilities and workspace isolation features.