Install

Install the iii engine and set up your agentic development environment.

Start a project

The recipe below installs the engine, creates a project from the harness template, and starts it. Select your llm provider, or select no llm. The harness project ships console, the browser ui for your running system, and the harness worker for agentic development and running agents inside your iii system. provider-openai and provider-anthropic are enabled by default; enable any other provider in worker-compose.yaml later.

select your llm provider

no llm

openai api

openai codex

anthropic

deepseek

kimi (moonshot)

openrouter

xai (grok)

z.ai

github copilot

llama.cpp (local)

# Install iii

$curl -fsSL https://install.iii.dev/iii/main/install.sh | sh

$iii project init my-app && cd my-app

# No llm. The base template starts just the console.

$

# provider-openai is enabled by default. Set OPENAI_API_KEY in .env:

$nano .env

$

# provider-anthropic is enabled by default. Set ANTHROPIC_API_KEY in .env:

$nano .env

$

# No api key. Uses your chatgpt subscription. Sign in with the codex cli so ~/.codex/auth.json exists:

$codex login

# Enable the provider in worker-compose.yaml:

$nano worker-compose.yaml

$

# Enable provider-deepseek in worker-compose.yaml, then set DEEPSEEK_API_KEY in .env:

$nano worker-compose.yaml

$nano .env

$

# Enable provider-kimi in worker-compose.yaml, then set MOONSHOT_API_KEY in .env:

$nano worker-compose.yaml

$nano .env

$

# Enable provider-openrouter in worker-compose.yaml, then set OPENROUTER_API_KEY in .env:

$nano worker-compose.yaml

$nano .env

$

# Enable provider-xai in worker-compose.yaml, then set XAI_API_KEY in .env:

$nano worker-compose.yaml

$nano .env

$

# Enable provider-zai in worker-compose.yaml, then set ZAI_API_KEY in .env:

$nano worker-compose.yaml

$nano .env

$

# No api key. Your github copilot subscription grants the models. Enable the provider in worker-compose.yaml:

$nano worker-compose.yaml

$

# Runs against your own llama-server, http://127.0.0.1:8080 by default. Enable the provider in worker-compose.yaml:

$nano worker-compose.yaml

$nano .env

# Start the engine and your project

$

# Sign in once the provider worker is up:

$iii trigger provider::github-copilot::login::start

# Open your browser to http://localhost:3113

Next Steps

Quickstart

Follow the Quickstart and explore a live iii application.

Use iii

Learn how to use iii in production.