Pi é um agente de codificação minimalista e extensível.

Configuração rápida

ollama launch pi

Isso instala o Pi, se necessário, configura o Ollama como provedor incluindo ferramentas web e inicia uma sessão interativa.

Para configurar sem iniciar:

ollama launch pi --config

Executar diretamente com um modelo

ollama launch pi --model qwen3.5:cloud

Modelos de nuvem também estão disponíveis em ollama.com.

Extensões

O Pi vem com quatro ferramentas principais: read, write, edit e bash. Todas as outras funcionalidades são adicionadas por meio do seu sistema de extensões.

Pacotes de funcionalidades sob demanda invocados por comandos /skill:name.

Instale a partir do npm ou git:

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

Veja todos os pacotes em pi.dev

Pesquisa web

O Pi pode usar ferramentas de pesquisa web e busca por meio do pacote @ollama/pi-web-search.

Ao iniciar o Pi por meio do Ollama, a instalação e atualização de pacotes é gerenciada automaticamente. Para instalar manualmente:

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

Autopesquisa com pi-autoresearch

pi-autoresearch traz loops de experimentos autônomos para o Pi. Inspirado no autoresearch de Karpathy, ele transforma qualquer métrica mensurável em um alvo de otimização: velocidade de testes, tamanho do pacote, tempo de build, perda de treinamento de modelo, pontuações do Lighthouse.

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

Diga ao Pi o que otimizar. Ele executa experimentos, faz benchmark de cada um, mantém as melhorias, reverte regressões e repete o processo — tudo de forma autônoma. Um painel integrado acompanha cada execução com pontuação de confiança para distinguir ganhos reais de ruído de benchmark.

/autoresearch optimize unit test runtime

Cada experimento mantido é commitado automaticamente. Cada experimento que falha é revertido. Quando você terminar, o Pi pode agrupar as melhorias em branches independentes para revisão e merge limpos.

Configuração manual

Instalação

Instale o Pi:

npm install -g @earendil-works/pi-coding-agent

Adicione um bloco de configuração ao arquivo ~/.pi/agent/models.json:

{
  "providers": {
    "ollama": {
      "baseUrl": "http://localhost:11434/v1",
      "api": "openai-completions",
      "apiKey": "ollama",
      "models": [
        {
          "id": "qwen3-coder"
        }
      ]
    }
  }
}

Atualize o arquivo ~/.pi/agent/settings.json para definir o provedor padrão:

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