Skip to main content
Pi is a minimal and extensible coding agent.

​
Install

Install Pi: 
npm install -g @mariozechner/pi-coding-agent

​
Usage with Ollama

​
Quick setup

ollama launch pi
This installs Pi, configures Ollama as a provider including web tools, and drops you into an interactive session. To configure without launching: 
ollama launch pi --config

​
Run directly with a model

ollama launch pi --model qwen3.5:cloud
Cloud models are also available at ollama.com.

​
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
See all packages at pi.dev 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
Tell Pi what to optimize. It runs experiments, benchmarks each one, keeps improvements, reverts regressions, and repeats — all autonomously. A built-in dashboard tracks every run with confidence scoring to distinguish real gains from benchmark noise. 
/autoresearch optimize unit test runtime
Each kept experiment is automatically committed. Each failed one is reverted. When you’re done, Pi can group improvements into independent branches for clean review and merge.

​
Manual setup

Add a configuration block to ~/.pi/agent/models.json: 
{
  "providers": {
    "ollama": {
      "baseUrl": "http://localhost:11434/v1",
      "api": "openai-completions",
      "apiKey": "ollama",
      "models": [
        {
          "id": "qwen3-coder"
        }
      ]
    }
  }
}
Update ~/.pi/agent/settings.json to set the default provider: 
{
  "defaultProvider": "ollama",
  "defaultModel": "qwen3-coder"
}