Start a project
The recipe below installs the engine, creates a project from our templates, and starts it. Once started you can explore the project via https://127.0.0.1:3113. Select your llm provider, or select no llm.# 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 only 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
$
# Set DEEPSEEK_API_KEY in .env:
$nano .env
$
# Set MOONSHOT_API_KEY in .env:
$nano .env
$
# Set OPENROUTER_API_KEY in .env:
$nano .env
$
# Set XAI_API_KEY in .env:
$nano .env
$
# Set ZAI_API_KEY in .env:
$nano .env
$
# No api key. Your github copilot subscription grants the models.
# Start the engine and your project
$
# Add the provider to your running project:
$iii trigger compose::add worker=provider-openai-codex
# Add the provider to your running project:
$iii trigger compose::add worker=provider-deepseek
# Add the provider to your running project:
$iii trigger compose::add worker=provider-kimi
# Add the provider to your running project:
$iii trigger compose::add worker=provider-openrouter
# Add the provider to your running project:
$iii trigger compose::add worker=provider-xai
# Add the provider to your running project:
$iii trigger compose::add worker=provider-zai
# Add the provider to your running project:
$iii trigger compose::add worker=provider-github-copilot
# Sign in once the provider worker is up:
$iii trigger provider::github-copilot::login::start
# Add the provider to your running project:
$iii trigger compose::add worker=provider-llamacpp
# Open your browser to http://127.0.0.1:3113
Next Steps
Quickstart
Follow the Quickstart and explore a live iii application.
Use iii
Learn how to use iii in production.