Maestro Builder

A modern web-based interface for building Maestro agents and workflows using AI assistance.

---

🚀 Quick Start

1. Clone the repo and enter the directory:

   git clone <your-repo-url>
   cd maestro-builder

2. Set up your Python virtual environment:

   • Make sure you have Python 3.11:

     python3 --version

   • Create and activate the virtual environment (must be at the top level of the project):

     python3 -m venv .venv
     source .venv/bin/activate

   • Install required dependencies:

     uv run pip install -r api/requirements.txt

   • Populate your .env file; needs to include OPENAI_API_KEY and OPENAI_BASE_URL

3. Install frontend dependencies:

   uv run npm install

4. Start everything with one command:

   ./start.sh

This will start:

• API backend (http://localhost:8001)
• Builder frontend (http://localhost:5174)
• Editing Agent backend (http://localhost:8002)
• Agent Generation backend (http://localhost:8003)
• Workflow Generation backend (http://localhost:8004)

To stop all services, run (optionally add -c to clear logs):

./stop.sh

Log files:

• API: logs/api.log
• Builder: logs/builder.log
• Editing Agent: logs/editing_agent.log
• Agent Generation: logs/maestro_agents.log
• Workflow Generation: logs/maestro_workflow.log