🤖 Enterprise-Grade Multi-Agent AI Orchestration Platform
Features • Installation • Usage • Agents • Contributing • License
Maestro V3 is a sophisticated multi-agent AI orchestration system that coordinates specialized AI agents to accomplish complex tasks. It features a beautiful desktop application with real-time agent collaboration, persistent memory, and extensible tool system.
Built with ❤️ by HimaAzab
| Agent | Role | Capabilities |
|---|---|---|
| Orchestrator | Planning & Strategy | Breaks down objectives into actionable tasks |
| Research | Information Gathering | Web search, documentation lookup |
| UI/UX Designer | Interface Design | Beautiful, responsive UI designs |
| Developer | Code Implementation | Clean, efficient code generation |
| Security | Vulnerability Analysis | Security review, threat detection |
| QA Tester | Quality Assurance | Testing, bug finding, edge cases |
| Documentation | Docs Generation | READMEs, API docs, comments |
| Refiner | Final Polish | Synthesize and polish outputs |
- File Operations - Read, write, and list files (sandboxed)
- Web Search - DuckDuckGo integration for research
- Code Executor - Sandboxed Python code execution
- Native Desktop App - Runs as a Windows application (no browser needed!)
- Real-time Collaboration - Watch agents work together via WebSocket
- Persistent Memory - SQLite database for project history
- Workflow Engine - DAG-based task execution with dependencies
- Multiple Model Presets - Basic, Standard, Advanced, and Cloud (GPT-4, Claude)
- Python 3.9+
- Node.js 18+ (for building frontend)
- Ollama - Download here (for local models)
# Clone the repository
git clone https://github.com/simplehima/maestro-agents.git
cd maestro-agents
# Install Python dependencies
pip install -r requirements.txt
# Build the frontend
cd frontend
npm install
npm run build
cd ..
# Run as web application
python app.py
# OR run as desktop application
python desktop_app.pypython build.pyThis creates MaestroV3.exe in the dist/ folder.
- Launch Maestro V3 (desktop app or web)
- Enter your project objective (e.g., "Build a REST API for a todo app")
- Select a model preset (Basic, Standard, Advanced, or Cloud)
- Click Start Orchestration
- Watch the agents collaborate in real-time!
You can intervene during orchestration by sending guidance messages to steer the agents.
| Preset | Models | Best For |
|---|---|---|
| Basic | llama3:8b | Quick prototypes |
| Standard | llama3:70b + codellama:13b | Balanced quality |
| Advanced | llama3:70b + codellama:34b | Production quality |
| Cloud | GPT-4o + Claude 3.5 | Maximum capability |
maestro-agents/
├── agents/ # Agent architecture
│ ├── __init__.py # Base classes, registry
│ └── specialized.py # 8 specialized agents
├── tools/ # Tool system
│ ├── __init__.py # Base tool classes
│ ├── file_tool.py # File operations
│ ├── web_search_tool.py
│ └── code_executor.py
├── frontend/ # TypeScript frontend
│ ├── src/
│ └── dist/
├── app.py # FastAPI backend
├── desktop_app.py # Desktop launcher
├── workflow_engine.py # DAG task execution
├── database.py # SQLite persistence
├── config.py # Model configuration
└── build.py # Build script
Contributions are welcome! Please read our Contributing Guidelines before submitting a Pull Request.
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
HimaAzab
- GitHub: @simplehima
- Ollama - Local LLM runtime
- FastAPI - Modern Python web framework
- PyWebView - Native desktop windows
- Lucide Icons - Beautiful icons
Made with ✨ by HimaAzab