Getting‐Started

🚀 Getting Started

This guide will help you get Maestro V2 up and running in minutes.

---

Prerequisites

Before installing Maestro V2, ensure you have:

Requirement	Version	Purpose
Python	3.9+	Backend runtime
Node.js	18+	Frontend build
Ollama	Latest	Local LLM runtime

Installing Ollama

Download and install Ollama from ollama.ai, then pull a model:

ollama pull llama3:8b

---

Installation

1. Clone the Repository

git clone https://github.com/simplehima/maestro-agents.git
cd maestro-agents

2. Install Python Dependencies

pip install -r requirements.txt

3. Build the Frontend

cd frontend
npm install
npm run build
cd ..

---

Running Maestro V2

Desktop Application (Recommended)

python desktop_app.py

This opens Maestro V2 in a native Windows window.

Web Application

python app.py

Then open http://localhost:8000 in your browser.

---

Your First Project

1. Launch Maestro V2
2. Enter an objective (e.g., "Create a REST API for a todo app")
3. Select a model preset (Basic for quick testing)
4. Click Start Orchestration
5. Watch the agents collaborate!

---

← Back to Home | Agents →