Quick Start

This guide gets you from zero to a working Maestro installation.

Prerequisites

• Node.js 22+ or Docker
• Anthropic API key — Get one at console.anthropic.com

Installation

Docker (Recommended)

1. Clone the repository

   git clone https://github.com/MaestroAgent/maestro.git
   cd maestro

2. Configure environment

   cp .env.example .env

   Edit .env and add your Anthropic API key:

   ANTHROPIC_API_KEY=sk-ant-xxxxx

3. Start Maestro

   docker compose up -d --build

4. Check the logs

   docker compose logs -f

Local Development

1. Clone and install

   git clone https://github.com/MaestroAgent/maestro.git
   cd maestro
   npm install

2. Configure environment

   cp .env.example .env

   Edit .env and add your Anthropic API key:

   ANTHROPIC_API_KEY=sk-ant-xxxxx

3. Run the CLI

   npm run cli

First Conversation

Once running, try these interactions:

You: Hello, what can you do?
Assistant: I can help with general questions, coding tasks,
project management, and more. I route requests to specialized
agents based on your needs.

You: What's 15% of 847?
Assistant: 15% of 847 = 127.05

You: Clone https://github.com/example/project
Assistant: Cloned to project. This is now your active project.

Running Different Interfaces

Maestro supports multiple channels. Run whichever fits your workflow:

# Interactive CLI
npm run cli

# Telegram bot (requires TELEGRAM_BOT_TOKEN in .env)
npm run dev

# REST API (runs on port 3000)
npm run api

Note

You can run multiple channels simultaneously using Docker Compose. Each channel connects to the same backend and shares memory.

CLI Commands

When using the CLI interface, these commands are available:

Command	Description
/help	Show available commands
/clear	Clear conversation history
/cost	Show token usage and cost estimate
/quit	Exit the CLI

Next Steps

• Configuration — Customize Maestro’s behavior
• Creating Agents — Build custom agents
• Telegram Integration — Set up the Telegram bot