Home

On this page

What is make-agent?

make-agent is an AI agent framework where your system prompt and tools are defined in a Makefile. Annotated targets become callable tools.

Before you start

  • Python 3.11 or newer
  • A working make binary
  • An API key for your chosen model provider (for example ANTHROPIC_API_KEY)

LLM model support

make-agent supports OpenAI, Anthropic, OpenRouter, and Ollama model providers through model strings passed to --model and --agent-model.

You can also use a llama.cpp-compatible server by configuring a matching model/provider endpoint in your environment and passing the corresponding model string.

uv run make_agent --agent-model ollama/gpt-oss:120b --model ollama/gpt-oss:120b
Tip: Use the same provider/model for both flags when you want consistent behavior between the main agent and delegated specialist agents.

Next steps

  1. Follow Quick Start to run your first agent.
  2. Explore common workflows.
  3. Use CLI reference when you need exact flags.