Skip to main content
Dari runs an agent project as a hosted API. An agent is described by dari.yml, published with the CLI, and then used through sessions that accept messages.

​
1. Install

curl -fsSL https://raw.githubusercontent.com/mupt-ai/dari-cli/main/install.sh | bash

​
2. Log In

dari auth login
This opens a browser and caches credentials for the CLI. In headless environments or CI, set DARI_API_KEY instead and skip browser login: 
export DARI_API_KEY=dari_...
See Authentication for creating and using API keys.

​
3. Make A First API Call

Raw HTTP requests use an org API key as a bearer token. After setting DARI_API_KEY, list your agents with: 
curl https://api.dari.dev/v1/agents \
  -H "Authorization: Bearer $DARI_API_KEY"

​
4. Create An Agent

dari init my-agent
cd my-agent
dari init writes the starter project: dari.yml, prompts/system.md, an example repo_search tool, an example skill, a README.md, and .gitignore.

​
5. Deploy

dari deploy .
Copy the agent_id from the output.

​
6. Send A Message

dari session send --agent <agent_id> 'hello'
This creates a session automatically and queues the first message. Copy the session.id from the response if you want to inspect events: 
dari session events <session_id> --limit 20
Edit the generated files, then run dari deploy . again to publish a new version. Prefer raw HTTP or live SSE updates? See the API Reference.