Quick setup
ollama launch pi
ollama launch pi --config
Run directly with a model
ollama launch pi --model qwen3.5:cloud
Extensions
Pi ships with four core tools:read, write, edit, and bash. All other capabilities are added through its extension system.
On-demand capability packages invoked via /skill:name commands.
Install from npm or git:
pi install npm:@foo/some-tools
pi install git:github.com/user/repo@v1
Web search
Pi can use web search and fetch tools via the@ollama/pi-web-search package.
When launching Pi through Ollama, package install/update is managed automatically.
To install manually:
pi install npm:@ollama/pi-web-search
Autoresearch with pi-autoresearch
pi-autoresearch brings autonomous experiment loops to Pi. Inspired by Karpathy’s autoresearch, it turns any measurable metric into an optimization target: test speed, bundle size, build time, model training loss, Lighthouse scores.
pi install https://github.com/davebcn87/pi-autoresearch
/autoresearch optimize unit test runtime
Manual setup
Install
Install Pi:npm install -g @earendil-works/pi-coding-agent
~/.pi/agent/models.json:
{
"providers": {
"ollama": {
"baseUrl": "http://localhost:11434/v1",
"api": "openai-completions",
"apiKey": "ollama",
"models": [
{
"id": "qwen3-coder"
}
]
}
}
}
~/.pi/agent/settings.json to set the default provider:
{
"defaultProvider": "ollama",
"defaultModel": "qwen3-coder"
}