Oh My Pi frente a Pi: el fork, las diferencias y cuál ejecutar

Oh My Pi es un fork duro de Pi, no un rival que creciera a su lado: el código fluyó de Pi → Oh My Pi, ambos proyectos siguen activos hoy y ahora optimizan cosas opuestas. Pi es un arnés de terminal deliberadamente minimalista que se amplía en TypeScript. Oh My Pi es la misma línea reconstruida como una superficie de programación con todo incluido, con LSP, un depurador, subagentes y una herramienta de navegador integrados. Ambos tienen licencia MIT y cuestan $0 de instalar, así que la decisión se refiere al flujo de trabajo, el modelo de ejecución y el formato de configuración, no a una tarifa de licencia.

Primero, los nombres, porque tres de ellos se confunden. Pi aquí significa el arnés de agente de pi.dev, publicado por Earendil Works desde earendil-works/pi. No es Pi de Inflection AI (pi.ai), ni la moneda Pi Network, ni Raspberry Pi. Oh My Pi significa el agente de omp.sh de can1357/oh-my-pi, cuyo binario es omp; no son las panaderías de tartas que dominan una búsqueda de esa frase, ni Oh My Zsh u Oh My Posh, pese a la semejanza de nombres. Y pi-mono no es un tercer producto: es el antiguo nombre del repositorio de Pi. github.com/badlogic/pi-mono ahora devuelve un 301 a earendil-works/pi, aunque la documentación de terceros todavía usa la ruta antigua; la página oficial de integración de Pi de DeepSeek literalmente se encuentra en /agent_integrations/pi_mono/.

Conviene precisar la dirección del fork, porque las búsquedas funcionan en ambos sentidos y la respuesta no es simétrica. El README de Oh My Pi indica en su propio encabezado que es un «Fork of Pi by @mariozechner» y enlaza a la URL anterior al cambio de nombre. GitHub informa fork: false y parent: null para él, porque se trata de un fork del código fuente y no del botón de fork; por eso la API no te lo dirá. El repositorio aún contiene docs/porting-from-pi-mono.md, una lista de comprobación de combinación cuyo último punto de sincronización registrado es el commit b21b42d, fechado el 22 de marzo de 2026. Ese marcador es la única evidencia de divergencia disponible externamente; esta página no puede confirmar si posteriormente hubo una sincronización no registrada.

Oh My Pi frente a Pi: ¿cuál deberías elegir?

Cinco ejes determinan la decisión, independientemente de desde qué dirección llegues, y solo uno de ellos trata sobre las funciones.

• Flujo de trabajo. Elige Pi si quieres un núcleo pequeño y pretendes escribir tú mismo las partes que faltan. Hasta la actualización de su documentación del 22 de septiembre de 2026, sus propios documentos de uso indicaban que «deliberadamente no incluye MCP integrado, subagentes, ventanas emergentes de permisos, modo de planificación, tareas pendientes ni bash en segundo plano», y te remitían a extensiones, paquetes, contenedores y tmux. La actualización eliminó esa frase y v0.99.0 convirtió después MCP en una extensión integrada que se carga de forma predeterminada; los subagentes, el modo de planificación, las tareas pendientes y las solicitudes de aprobación siguen siendo extensiones en v0.99.2. Elige Oh My Pi si quieres tener esas funciones integradas desde el primer día y no quieres mantener una extensión.
• Permisos y modelo de ejecución. Ninguna de las opciones predeterminadas es segura, así que elige según el modo de fallo con el que puedas convivir. Pi no tiene sistema de permisos y lo declara explícitamente. Oh My Pi tiene uno real de tres niveles y se distribuye configurado de forma predeterminada como yolo. Si necesitas solicitudes por herramienta, Oh My Pi puede ofrecértelas tras una línea de configuración; Pi no puede hacerlo sin una extensión.
• Protocolo y límites de planificación. Si tu ruta de modelo es un endpoint de terceros compatible con OpenAI o Anthropic, ambos pueden acceder a él, pero Oh My Pi documenta nueve dialectos de red, mientras que Pi documentaba cuatro hasta la actualización de su documentación del 22 de septiembre de 2026, y añade una ruta mediante variables de entorno que Pi no tiene. La diferencia de dialectos es menor en el código que sobre el papel: el código fuente de Pi en v0.99.2 envía el api de un proveedor personalizado a cualquiera de diez implementaciones integradas, seis de ellas nunca documentadas para ese uso. Si tu ruta es una suscripción de OAuth —Claude Pro/Max, Codex, GitHub Copilot—, ambos clientes la conectan mediante /login y almacenan un token del proveedor, que un gateway intermedio rechazaría; la documentación de proveedores de Oh My Pi da ese motivo para que una clave models.yml tenga deliberadamente prioridad sobre el OAuth almacenado. No incluyas los planes de programación chinos en ese grupo: Pi enumera ZAI/GLM, Kimi For Coding y Qwen Token Plans en su tabla de claves de API (ZAI_API_KEY, KIMI_API_KEY, QWEN_TOKEN_PLAN_API_KEY), y Oh My Pi los etiqueta como plan en lugar de oauth, por lo que son proveedores normales con clave en ambos.
• Ruta de costes. El cliente es gratuito en ambos lados y ninguno cambia tu tarifa por token. La asimetría es que Pi tiene un gateway de pago propio (Radius, operado por la misma empresa) conectado a su propio /login, mientras que Oh My Pi no vende ninguna ruta alojada; el único servidor que opera es el relay detrás de los enlaces de sesión /collab, que no cobra nada.
• Coste de migración. Aproximadamente un bloque de proveedor, reescrito. Los formatos y directorios de configuración difieren —JSON en ~/.pi, YAML en ~/.omp— y ninguno de los repositorios documenta una herramienta de importación. Se comparten un par de nombres de variables de entorno, con las salvedades indicadas abajo.

Lo que no debería decidirlo: los números de versión. Oh My Pi volvió a numerarse al hacer el fork, por lo que su 18.2.7 y el 0.86.1 de Pi corresponden a esquemas distintos, no a dieciocho versiones de madurez adicional.

Qué difiere realmente entre ambos

Leído en la documentación propia de ambos repositorios el 19 de septiembre de 2026: las páginas de visión general, seguridad y modelos de Pi, y las páginas de README, approval-mode y providers de Oh My Pi. Las filas de diseño declarado, MCP, modelo de permisos y dialectos de Pi se volvieron a comprobar el 1 de octubre de 2026 contra su documentación actualizada, README y código fuente en v0.99.2. Los recuentos de capacidades de la fila de Oh My Pi son afirmaciones del propio proyecto; no se publica ninguna metodología para ellos, y su tabla de benchmarks del README también es una afirmación del proveedor que esta página no reproduce.

Ambos siguen activos. Ninguna métrica resuelve «cuál es más grande»

El error más común sobre este par consiste en tratar uno de ellos como abandonado o sustituido. Ambos enviaron código el día de esta comprobación.

Cifras del repositorio, versiones y estrellas obtenidas de la API de GitHub, consultada el 21 de septiembre de 2026; recuentos de descargas de la API de descargas de npm para la semana terminada el 16 de septiembre de 2026. No conviertas ninguna de las dos columnas en un veredicto de adopción. La comparación de npm, en particular, no es equivalente: la documentación propia de Pi comienza con npm install -g, mientras que el README de Oh My Pi documenta curl-to-shell, Homebrew, Bun, Nix, PowerShell y mise y nunca proporciona un comando de npm, por lo que npm lo subestima materialmente en una cantidad que nada de aquí puede medir. Las estrellas favorecen a Pi; la cadencia de versiones favorece a Oh My Pi; cualquier frase sobre popularidad basada en una sola métrica será incorrecta en al menos una dirección.

Evidencia neutral de terceros de que ambos siguen vigentes, si la quieres sin métricas: Ollama publica una página de integración para Oh My Pi y otra para Pi, y DeepSeek también publica una guía de integración de agentes para cada uno; su guía de Pi sigue archivada bajo la ruta antigua pi_mono. Las cuatro páginas respondieron el 21 de septiembre de 2026.

Dirigir cualquiera de los dos a tu propio endpoint

Aquí es donde el fork resulta más visible y donde una /v1 incorrecta puede costarte una tarde. Ambos clientes pueden acceder a un endpoint de terceros compatible con OpenAI o Anthropic, pero mediante mecanismos distintos y convenciones de URL opuestas.

Oh My Pi tiene una ruta mediante variables de entorno que Pi no tiene. Su proveedor de Anthropic resuelve la URL base mediante normalizeAnthropicBaseUrl($env.ANTHROPIC_BASE_URL), por delante del valor predeterminado oficial, y ese normalizador elimina un /v1 final; por tanto, tanto https://api.kunavo.com como https://api.kunavo.com/v1 llegan al mismo host. Leído en packages/ai/src/providers/anthropic-state.ts, donde se definen resolveDirectAnthropicBaseUrl() y el normalizador, el 19 de septiembre de 2026; procede del código fuente, no de una solicitud que hayamos realizado.

# Oh My Pi honours ANTHROPIC_BASE_URL for its built-in anthropic provider.
# normalizeAnthropicBaseUrl() strips a trailing /v1, so both forms resolve
# to the same host here. Pi ships no equivalent gateway base-URL variable.
export ANTHROPIC_API_KEY="$KUNAVO_API_KEY"
export ANTHROPIC_BASE_URL="https://api.kunavo.com"
omp

Esa ruta incluye una trampa de precedencia. El orden documentado de Oh My Pi coloca una models.yml apiKey en la posición 2, por encima de el OAuth almacenado en la posición 3, pero una variable de entorno del proveedor en la posición 5, por debajo de este. Así que, si ya has iniciado sesión mediante /login en Anthropic, el token de la suscripción gana a ANTHROPIC_API_KEY y la clave de tu gateway nunca se utiliza. Fija la clave en la configuración o cierra primero la sesión de ese proveedor.

Para un proveedor con nombre, Oh My Pi utiliza YAML; aquí vuelve a entrar el /v1, porque su ruta de OpenAI añade /chat/completions literalmente a la URL base recortada.

providers:
  kunavo:
    baseUrl: https://api.kunavo.com/v1   # /v1 REQUIRED: omp appends /chat/completions
    api: openai-completions              # use anthropic-messages, and then drop /v1
    apiKey: KUNAVO_API_KEY               # env var name, a literal, or "!cmd"
    authHeader: true                     # send Authorization: Bearer <key>
    models:
      - id: claude-sonnet-5
        contextWindow: 200000
        maxTokens: 64000

Para apuntar Pi a un gateway solo tienes una ruta: ~/.pi/agent/models.json. Pi no lee ANTHROPIC_BASE_URL; una búsqueda de código en el repositorio realizada el 19 de septiembre de 2026 devuelve dos coincidencias exactas, ambas no relacionadas con sobrescrituras (una constante de Cloudflare AI Gateway y un script de generación de modelos), y tampoco existe un OPENAI_BASE_URL independiente. Sí existe una variable de URL base, pero no es una vía de escape general: AZURE_OPENAI_BASE_URL, indicada en la documentación de proveedores de Pi, apunta el proveedor Azure OpenAI a tu propio recurso de Azure y a ningún otro lugar.

{
  "providers": {
    "kunavo": {
      "baseUrl": "https://api.kunavo.com",
      "api": "anthropic-messages",
      "apiKey": "$KUNAVO_API_KEY",
      "models": [
        {
          "id": "claude-sonnet-5",
          "contextWindow": 200000,
          "maxTokens": 64000
        }
      ]
    }
  }
}

En cuanto al sufijo, la propia documentación de Pi nunca lo ha resuelto, y deberías saberlo en vez de confiar en un ejemplo. Hasta la actualización de su documentación del 22 de septiembre de 2026, su página de modelos mostraba un proxy anthropic-messages como https://proxy.example.com/v1 en un lugar y como https://proxy.example.com sin sufijo en otro; la actualización eliminó ambos sin resolverlo. La forma sin sufijo es la que debes seguir, y el razonamiento se deriva del código fuente, no de pruebas en tiempo de ejecución: Pi no incluye nada parecido al normalizador de Oh My Pi que elimina /v1 en la ruta anthropic-messages; la única normalización que describe su documentación es específica de Azure: las URL raíz de recursos en los dominios propios de Azure «se normalizan a la ruta de la API de OpenAI»; su valor predeterminado integrado de Anthropic es https://api.anthropic.com sin /v1, mientras que su valor predeterminado de OpenAI es https://api.openai.com/v1; y para anthropic-messages entrega model.baseUrl directamente al SDK oficial de Anthropic, que añade /v1/messages por sí mismo. Un /v1 produciría allí /v1/v1/messages. Kunavo documenta la misma convención en su página de URL base: solo el origen para clientes de estilo Anthropic y /v1 para los de estilo OpenAI.

Conviene planificar teniendo en cuenta dos límites más. Hasta la actualización de la documentación de Pi del 22 de septiembre de 2026, su tabla documentada enumeraba cuatro dialectos para proveedores personalizados, aunque el repositorio incluye controladores adicionales; la actualización eliminó la tabla sin nombrar una lista sustituta, por lo que esos cuatro siguen siendo la única superficie que Pi ha documentado para proveedores personalizados. Sin embargo, los controladores adicionales no están reservados para los integrados: el código fuente de Pi en v0.99.2 tipa un models.json api como cadena libre y lo envía a cualquiera de las diez implementaciones registradas que coincida (BUILTIN_APIS en packages/ai/src/compat.ts), así que un proveedor personalizado puede nombrar bedrock-converse-stream o google-vertex; no está documentado ni probado aquí si alguno funciona contra un endpoint de terceros. En Oh My Pi, además, disabledProviders se comprueba antes de las credenciales: un ID de proveedor incluido en esa lista desaparece silenciosamente, independientemente de la clave que proporciones; mientras que las matrices de configuración se sustituyen por completo mediante la capa de mayor precedencia, en lugar de fusionarse, por lo que una lista a nivel de proyecto descarta silenciosamente la global. Ambos proyectos también incluyen vías de escape de compatibilidad que podrías necesitar realmente en un gateway: disableStrictTools de Oh My Pi, supportsEagerToolInputStreaming de Pi y allowEmptySignature. Aquí no se ha probado si Kunavo acepta los esquemas estrictos predeterminados, los marcadores de caché o la transmisión anticipada de entradas de herramientas de ninguno de los dos clientes.

Cuánto cuesta realmente cambiar

Menos de lo que sugiere la diferencia de números de versión y más que copiar un archivo. En el árbol de documentación de ninguno de los repositorios hay un comando de importación, un conversor de sesiones ni un migrador de configuración documentados, así que planifica volver a escribir el bloque del proveedor en el otro formato: de JSON a YAML o al revés. Las credenciales tampoco se trasladan: Pi las almacena en ~/.pi/agent/auth.json, mientras que Oh My Pi mantiene un almacén de autenticación SQLite en ~/.omp/agent/agent.db.

Las variables de entorno llegan menos lejos de lo que sugiere la ascendencia compartida, así que lee esto con atención. Oh My Pi sigue leyendo los nombres con prefijo PI_, entre ellos PI_CONFIG_DIR y PI_CODING_AGENT_DIR, pero estos reubican los directorios de Oh My Pi; por tanto, exportar uno en un perfil de shell compartido con Pi hace que ambos clientes apunten a la misma ruta, en lugar de volver portátil una configuración. La correspondencia de OMP_ a PI_ descrita en su referencia de variables de entorno es aún más limitada: ese documento indica que la regla se aplica dentro de cada archivo .env analizado y explícitamente «no a variables arbitrarias heredadas del proceso principal». Lo que no se trasladará en absoluto es cualquier cosa creada para el arnés: una extensión de TypeScript de Pi está escrita contra la API de Pi, y aproximadamente seis meses de desarrollo mantenido por separado desde el marcador de sincronización del 22 de marzo de 2026 es precisamente el periodo en el que esas API divergen. Prueba una extensión en lugar de suponer que se puede portar.

El dinero es el mismo en ambos lados

Ninguno de los clientes te cobra, así que cambiar entre ellos modifica en cero tu gasto en modelos. La variable es la ruta por la que compras tokens, y en eso difieren de una forma: Pi tiene un gateway de pago propio y Oh My Pi no. Radius es operado por Earendil, es de código cerrado, se accede mediante el propio /login de Pi, y su FAQ indica que cobra «las tarifas que tenemos con nuestro procesador de pagos además de los precios de lista»; no publica el porcentaje, por lo que el total de Radius no puede calcularse externamente. El único gateway de Oh My Pi es omp auth-gateway serve, software que alojas tú, con la seguridad del transporte delegada en el operador.

Hay algo que conviene eliminar antes de incluirlo en un presupuesto: una suscripción Claude Pro o Max iniciada en cualquiera de los dos arneses no equivale a uso gratuito. Hasta que la actualización de su documentación del 22 de septiembre de 2026 eliminó la frase, la documentación de proveedores de Pi decía que el uso de un arnés de terceros «consume uso adicional y se factura por token, no contra los límites del plan de Claude»; la advertencia que Pi muestra cuando un modelo de Anthropic se ejecuta con autenticación de suscripción sigue diciendo que «consume uso adicional y se factura por token, no contra los límites de tu plan de Claude» (fuente, v0.99.2). No se encontró una declaración equivalente en la documentación de Oh My Pi, así que no supongas que se comporta de otra forma; compruébalo en tu propia cuenta.

Para la ruta del gateway, aquí tienes el cálculo sobre la carga de trabajo y no sobre el cliente. Supón un mes de trabajo constante del agente: 5,000,000 tokens de entrada sin caché y 400,000 tokens de salida, sin lecturas ni escrituras de caché y sin cargos por imágenes o herramientas. Las tarifas son los precios vigentes del catálogo de Kunavo por millón de tokens.

Son estimaciones ilustrativas de tokens bajo los supuestos anteriores, no costes medidos de tareas ni un límite superior de una factura. La columna es idéntica para ambos clientes porque el cliente no es una variable de precios, pero la carga de trabajo sí puede serlo: la herramienta task de Oh My Pi distribuye subagentes en paralelo, y cada agente paralelo lleva su propio contexto, lo que supone un multiplicador de tokens de entrada cuyo tamaño ninguna tabla puede calcular por ti. Mídelo en un cambio acotado antes de ampliar la estimación.

Dos salvedades del lado de Kunavo deben incluirse en la misma cifra. El importe del catálogo es un mínimo de facturación, no un límite máximo: cuando el upstream comunica su cargo, la factura es el mayor entre el coste del catálogo y el coste del upstream multiplicado por el margen aplicable, como explica la guía de facturación. Y la recarga mínima es de $10 de crédito prepagado: el efectivo necesario para financiar una cuenta, no una tarifa por tarea ni una suscripción.

Kunavo publica una guía de configuración para cada cliente —Pi y Oh My Pi—, pero no ha probado ninguno en tiempo de ejecución contra su endpoint, y una guía de configuración es una referencia de configuración, no una prueba de compatibilidad. Ambas configuraciones anteriores están redactadas a partir de documentación y código fuente publicados, y deberías verificarlas en tu propia máquina. Mantén disponible una ruta funcional mientras pruebas una. Cuando quieras calcular el precio de una tarea real en lugar del de un modelo, crea una cuenta de Kunavo, añade fondos y ejecuta un cambio acotado contra el modelo que hayas seleccionado. Si todavía estás eligiendo un arnés en lugar de un proveedor, precios del agente de programación Pi desglosa las cuatro rutas de facturación de Pi, y Pi frente a OpenCode compara Pi con otro cliente que cuenta con una guía de configuración de Kunavo publicada.

Preguntas frecuentes

Los árboles de documentación y los paquetes npm de ambos repositorios se comprobaron el 19 de septiembre de 2026, y las afirmaciones sobre la URL base y el orden de credenciales se leyeron de los archivos fuente nombrados en línea en esa misma fecha; las métricas de los repositorios y los historiales de versiones se volvieron a leer el 21 de septiembre de 2026. Tras la actualización de documentación de Pi del 22 de septiembre de 2026, sus ejemplos de URL base de anthropic-messages, la frase de normalización de Azure, los valores documentados de api y el orden de credenciales se volvieron a comprobar el 1 de octubre de 2026 frente a la documentación actualizada y al código fuente en v0.99.2. Ese mismo día, después de que Pi v0.99.0 incorporara MCP, se volvieron a comprobar su lista de funciones omitidas, la redacción sobre la confianza del proyecto y el diseño declarado frente a sus páginas de uso, MCP, configuración y seguridad, así como el README, los valores de api que utiliza su distribución interna, la línea de uso adicional frente a la advertencia de terminal de ese código fuente y el índice de integraciones de este sitio. También el 1 de octubre de 2026, los valores documentados de api de Oh My Pi se volvieron a comprobar frente a su docs/models.md y su esquema models.yml en v18.4.8. Las tarifas de Kunavo se representan a partir del catálogo activo y cada cifra en dólares aquí es aritmética ilustrativa de tokens. Ninguno de los dos clientes se ha probado en ejecución contra Kunavo, y no se pretende implicar ninguna comparación de rendimiento o de benchmarks entre ambos proyectos: no existe ninguna que esta página pueda citar.