Pi는 최소한의 기능을 갖추고 확장 가능한 코딩 에이전트입니다.

빠른 설정

ollama launch pi

필요한 경우 Pi를 설치하고, 웹 도구를 포함해 Ollama를 제공자로 설정한 후, 대화형 세션을 시작합니다.

실행하지 않고 설정하려면:

ollama launch pi --config

모델로 직접 실행

ollama launch pi --model qwen3.5:cloud

클라우드 모델은 ollama.com에서도 사용할 수 있습니다.

확장 기능

Pi에는 read, write, edit, bash의 4가지 핵심 도구가 기본 탑재되어 있습니다. 그 외의 모든 기능은 확장 시스템을 통해 추가할 수 있습니다.

/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에 최적화할 대상을 알려주세요. 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"
}