Getting Started

Install Zil and run your first agent in five minutes.

Prerequisites

• Python 3.11+
• pip (or pipx)

1. Install

pip install 'zil-ai[adk]'

Verify:

zil --version
# zil, version 0.1.12

2. Create a project

zil init my-agent

The CLI prompts for your LLM provider (Gemini, Anthropic, OpenAI, or Vertex AI), then scaffolds the project, creates a virtual environment, and installs dependencies.

Use --non-interactive to accept all defaults:

zil init my-agent --non-interactive

3. Configure your API key

cd my-agent
source .venv/bin/activate
cp my_agent/.env.example my_agent/.env

Edit my_agent/.env and add your API key. The default provider is Gemini — get a key at aistudio.google.com/apikey .

For other providers, see Adapters — LLM.

4. Run your agent

# Interactive CLI
zil run
 
# Or browser-based chat UI
zil web

5. What to edit

The generated agent.py uses one function to wire everything:

import zil
 
root_agent = zil.create_agent(
    tools=[],  # add your tool functions here
)

See SDK Reference for all create_agent() options.

What’s next