Quickstart

Install and Start Mix

Clone the Mix repository and start the development server:

git clone https://github.com/recreate-run/mix.git
cd mix
make dev

This will start both the backend agent and devtools. Leave this terminal running.

Setup Examples

Open a new terminal tab and clone the examples repository:

git clone https://github.com/recreate-run/mix-cookbooks.git
cd mix-cookbooks/python_examples
uv sync

Configure API Keys

In the mix-cookbooks/python_examples directory, rename .env.example to .env:

cp .env.example .env

Then edit .env and add your API keys. At minimum, you need an Anthropic API key to run the demo:

ANTHROPIC_API_KEY=your_key_here  # Required
GEMINI_API_KEY=your_key_here     # Optional - for ReadMedia tool
BRAVE_API_KEY=your_key_here      # Optional - for web search

• Anthropic API key: Required (Claude API or Claude Code subscription)
• Brave API key: Optional, for web search tool (Get free key)
• Gemini API key: Optional, for ReadMedia tool (Get free key)

Run Your First Demo

From the mix-cookbooks/python_examples directory, run:

uv run demos/portfolio_analysis.py