Maestro

Maestro is a tool for managing and running AI agents and workflows.

Installation

pip install git+https://github.com/AI4quantum/maestro.git@v0.5.0

Note: If using scoring or crewai agents, install:

pip install "maestro[crewai] @ git+https://github.com/AI4quantum/maestro.git@v0.5.0"

Usage

1. Run a workflow:

maestro run <workflow_path>

2. Create an agent:

maestro create <agent_path>

3. Validate a workflow or agent:

maestro validate <path>

4. Serve workflows with streaming:

maestro serve <agents_file> <workflow_file>

Streaming API

Maestro provides real-time streaming capabilities for workflows.

Quick Example

# Start streaming server
maestro serve agents.yaml workflow.yaml

# Test streaming
curl -X POST "http://localhost:8000/chat/stream" \
  -H "Content-Type: application/json" \
  -d '{"prompt": "Your prompt"}' \
  --no-buffer

Development

1. Clone the repository:

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

2. Install development dependencies:

uv sync --all-extras

3. Run tests:

uv run pytest

4. Run the formatter:

uv run ruff format

5. Run the linter:

uv run ruff check --fix

Builder Frontend and Demos

The Maestro Builder (web interface) has been moved to a separate repository: maestro-builder

Example use cases are also in a separate repository: maestro-demos

Contributing

Please read CONTRIBUTING.md for details on our code of conduct and the process for submitting pull requests.

License

This project is licensed under the Apache License - see the LICENSE file for details.