Getting started

Follow these quick steps to spin up Distri locally.

1. Define your agent

Create hello.md with a minimal agent definition.

2. Run Distri

Use distri run for interactive CLI sessions or tasks.

3. Go headless

Start distri serve when you need REST/WebSocket APIs.

---
name = "hello_agent"
description = "A minimal assistant that answers briefly"
max_iterations = 1

[tools]
external = []

[model_settings]
model = "gpt-4.1-mini"
temperature = 0.3
max_tokens = 200
---

# ROLE
You are a concise assistant. Answer briefly and helpfully.

# TASK
{{task}}

For a full Google Maps agent example, see the guide: Integrating within your product.

distri run hello_agent --task "Say hello to the world"

distri serve