Skip to content

Pi es un agente de codificación mínimo y extensible.

Configuración rápida

bash
ollama launch pi

Esto instala Pi si es necesario, configura Ollama como proveedor incluyendo herramientas web, e inicia una sesión interactiva.

Para configurar sin iniciar la sesión:

shell
ollama launch pi --config

Ejecutar directamente con un modelo

shell
ollama launch pi --model qwen3.5:cloud

Los modelos en la nube también están disponibles en ollama.com.

Extensiones

Pi incluye cuatro herramientas principales: read, write, edit y bash. Todas las demás capacidades se añaden a través de su sistema de extensiones.

Paquetes de capacidades bajo demanda que se invocan mediante comandos /skill:name.

Instalar desde npm o git:

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

Consulta todos los paquetes en pi.dev

Búsqueda web

Pi puede usar herramientas de búsqueda web y obtención de contenido a través del paquete @ollama/pi-web-search.

Al iniciar Pi a través de Ollama, la instalación y actualización de paquetes se gestiona automáticamente. Para instalar manualmente:

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

Autoresearch con pi-autoresearch

pi-autoresearch aporta bucles de experimentación autónomos a Pi. Inspirado en el autoresearch de Karpathy, convierte cualquier métrica medible en un objetivo de optimización: velocidad de pruebas, tamaño del paquete, tiempo de compilación, pérdida de entrenamiento del modelo, puntuaciones de Lighthouse.

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

Indica a Pi qué optimizar. Ejecuta experimentos, realiza un benchmark de cada uno, conserva las mejoras, revierte las regresiones y repite el proceso, todo de forma autónoma. Un panel integrado rastrea cada ejecución con puntuación de confianza para distinguir las ganancias reales del ruido en los benchmarks.

bash
/autoresearch optimize unit test runtime

Cada experimento conservado se confirma automáticamente en el repositorio. Cada experimento fallido se revierte. Cuando termines, Pi puede agrupar las mejoras en ramas independientes para una revisión y fusión limpias.

Configuración manual

Instalación

Instala Pi:

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

Añade un bloque de configuración al archivo ~/.pi/agent/models.json:

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

Actualiza el archivo ~/.pi/agent/settings.json para establecer el proveedor predeterminado:

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