Pi 是一款輕量且可擴充的編碼代理程式。

快速設定

ollama launch pi

這段指令會自動安裝 Pi（若尚未安裝）、將 Ollama 設定為供應商並包含網路工具，最後進入互動式會話。

若只想進行設定而不啟動：

ollama launch pi --config

直接搭配模型執行

ollama launch pi --model qwen3.5:cloud

雲端模型也可在 ollama.com 取得。

擴充功能

Pi 內建四種核心工具：read、write、edit 和 bash。所有其他功能都透過其擴充系統加入。

可透過 /skill:name 指令按需呼叫功能套件。

可從 npm 或 git 安裝：

pi install npm:@foo/some-tools
pi install git:github.com/user/repo@v1

所有套件請見 pi.dev

網路搜尋

Pi 可透過 @ollama/pi-web-search 套件使用網路搜尋與抓取工具。

透過 Ollama 啟動 Pi 時，套件安裝與更新會自動管理。若要手動安裝：

pi install npm:@ollama/pi-web-search

使用 pi-autoresearch 進行自動研究

pi-autoresearch 為 Pi 帶來自主實驗循環。靈感源自 Karpathy 的 autoresearch，它能將任何可量化的指標轉為最佳化目標：測試速度、套件大小、構建時間、模型訓練損失、Lighthouse 分數。

pi install https://github.com/davebcn87/pi-autoresearch

告訴 Pi 要最佳化的目標，它會自動執行實驗、為每次實驗進行基準測試、保留有改善的版本、回滾效能退化的版本，並重複此流程。內建的儀表板會追蹤每次執行結果，透過信心評分區分真實改善與基準測試雜訊。

/autoresearch optimize unit test runtime

每次保留的實驗會自動提交，每次失敗的實驗會自動回滾。完成後，Pi 可將改善內容整理到獨立分支，方便乾淨地審查與合併。

手動設定

安裝

安裝 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 以設定預設供應商：

{
  "defaultProvider": "ollama",
  "defaultModel": "qwen3-coder"
}