Tutorial de Oh My Pi: crea una app completa con Grok como tu agente de programación

¿Por qué usar Oh My Pi?

Un buen agente de programación necesita dos cosas: un modelo agentivo potente y un arnés de código sólido.

El modelo aporta la inteligencia. Para este tutorial usamos Grok 4.6, que xAI ha diseñado para programación, agentes de larga ejecución y trabajo multi‑paso sobre bases de código completas. Admite una ventana de contexto de 500.000 tokens, entrada de imágenes, function calling, ejecución de código y búsqueda web.

Pero incluso el mejor modelo se queda corto si su arnés solo le permite leer y escribir texto. Para trabajar como un desarrollador real, el modelo necesita:

• Inspeccionar un repositorio y editar archivos de forma fiable
• Ejecutar comandos y lanzar tests
• Leer diagnósticos y depurar fallos
• Buscar documentación y verificar que sus cambios realmente funcionan

Eso es lo que aporta OMP: integración con LSP, un depurador real, ejecución persistente de código, navegador y herramientas web, integración con GitHub, memoria y subagentes en paralelo. Junto con el modelo, crean el bucle agentivo completo:

Planificar → inspeccionar → editar → ejecutar → depurar → probar → verificar

El modelo decide qué hacer y OMP le da las herramientas para hacerlo. Y como OMP es compatible con más de 60 proveedores de IA, no te quedas atado a Grok. El mismo flujo sirve tanto si conectas Grok, Claude u otro modelo.

Instalar Oh My Pi

Oh My Pi es un fork del agente de programación Pi de código abierto, creado por Stencil Labs, y se ha convertido rápidamente en uno de los agentes de terminal más populares, con más de 34.000 estrellas en GitHub. Está pensado para desarrolladores que quieren un entorno listo para usar sin dedicar tiempo a montar y configurar una pila de agentes a medida.

OMP funciona en Linux, macOS y Windows.

En Linux o macOS, ejecuta:

curl -fsSL https://omp.sh/install | shCon la tecnología de

En Windows PowerShell:

irm https://omp.sh/install.ps1 | iexCon la tecnología de

También puedes instalarlo globalmente con Bun (versión 1.3.14 o posterior):

bun install -g @oh-my-pi/pi-coding-agentCon la tecnología de

Si tras la instalación no se reconoce el comando omp, reinicia la terminal o revisa la salida del instalador para ver la ruta de instalación.

Luego, verifica la instalación:

omp --versionCon la tecnología de

Por ejemplo:

omp/18.0.6Con la tecnología de

Si aparece un número de versión, OMP está instalado correctamente y el comando omp está listo.

Configurar el acceso a SpaceXAI

Para usar Grok con Oh My Pi, tienes dos opciones.

Si solo estás probando el modelo o siguiendo este tutorial, te recomiendo usar la API de xAI. Crea una cuenta en https://console.x.ai/, añade una pequeña cantidad de crédito prepago y genera una clave de API. xAI descuenta el uso directamente del saldo, lo que facilita controlar cuánto gastas.

Si piensas usar Grok para programar a menudo, quizá te compense una suscripción a SuperGrok. OMP es compatible con SuperGrok mediante OAuth de SpaceXAI, así que puedes conectar tu suscripción con /login en lugar de pagar cada solicitud a la API por separado.

Para este tutorial usaremos la API porque es más fácil de probar y controlar el coste.

Crea tu clave de API en la consola de desarrolladores de SpaceXAI y guárdala de forma segura. OMP busca automáticamente la variable de entorno XAI_API_KEY.

En Linux o macOS:

export XAI_API_KEY="your-xai-api-key"Con la tecnología de

Para mantenerla tras reiniciar la terminal:

echo 'export XAI_API_KEY="your-xai-api-key"' >> ~/.bashrc
source ~/.bashrcCon la tecnología de

En Windows PowerShell:

$env:XAI_API_KEY="your-xai-api-key"Con la tecnología de

Puedes consultar los modelos Grok disponibles con:

omp models xaiCon la tecnología de

Inicia Oh My Pi con Grok

Crea un directorio nuevo para probar el agente de programación:

mkdir grok-pi-demo
cd grok-pi-demoCon la tecnología de

Inicializa un repositorio Git para que OMP pueda seguir los cambios que realiza:

git initCon la tecnología de

Ahora inicia Oh My Pi:

ompCon la tecnología de

En el primer arranque, OMP puede abrir un asistente breve para configurar proveedores, búsqueda web y la interfaz. También puedes ejecutar omp setup en cualquier momento para volver a abrirlo.

Como ya configuramos la variable de entorno XAI_API_KEY, no necesitas volver a iniciar sesión en xAI. Pulsa Esc cuando termines la configuración del proveedor.

Si usas la suscripción SuperGrok en lugar de créditos de API, selecciona xAI Grok OAuth (SuperGrok o X Premium+) en la pantalla de inicio de sesión.

Cuando se abra OMP, escribe:

/modelCon la tecnología de

Selecciona xAI en la lista de proveedores y elige:

grok-4.6Con la tecnología de

Para usar el nuevo Grok 4.7, selecciona grok-4.7 aquí. El resto del tutorial no cambia.

OMP también muestra información útil del modelo, como su ventana de contexto, precios, soporte de razonamiento y capacidades de visión.

Ya tienes Grok funcionando dentro de Oh My Pi como agente de programación en terminal. A partir de aquí puede usar las herramientas integradas de OMP para inspeccionar archivos, modificar código, ejecutar comandos, lanzar pruebas, depurar incidencias y abordar tareas de desarrollo más grandes.

Explora las funciones integradas de Oh My Pi

Oh My Pi incluye 31 herramientas integradas y compatibilidad con más de 60 proveedores de IA, por lo que la mayoría de flujos de programación funcionan sin instalar plugins adicionales ni servidores MCP.

Algunas de las capacidades más útiles incluyen:

• Gestión de archivos: Leer, crear, editar, buscar y modificar archivos de forma estructural.

• Acceso a terminal: Ejecutar comandos de shell y gestionar procesos directamente desde el agente.

• Ejecución de código: Ejecutar sesiones persistentes de Python y JavaScript.

• Integración LSP: Navegar definiciones, encontrar referencias, renombrar símbolos, ver diagnósticos y aplicar acciones de código.

• Depurador: Depurar aplicaciones en Python, Go, C/C++ y otros lenguajes compatibles mediante integraciones DAP.

• Búsqueda web: Buscar documentación, GitHub, Stack Overflow, Reddit, registros de paquetes, papers y la web en general.

• Automatización de navegador: Abrir e interactuar con sitios web usando un navegador basado en Chromium.

• Subagentes: Dividir tareas más grandes entre múltiples agentes en paralelo.

• Herramientas de GitHub: Trabajar con repos, issues, pull requests, búsqueda de código y GitHub Actions.

• Memoria: Guardar y recordar información útil del proyecto entre sesiones.

• Comprensión de imágenes: Inspeccionar capturas de pantalla, diagramas y otras imágenes locales.

• Generación de imágenes: Generar o editar imágenes con proveedores de IA compatibles.

• Texto a voz: Generar voz con xAI Grok Voice.

• Archivos remotos: Leer archivos en máquinas remotas mediante rutas ssh://.

• Gestión de sesiones: Crear checkpoints, retroceder, ramificar, reanudar y gestionar sesiones largas.

• Orquestación de agentes: Palabras clave como orchestrate y workflowz en tu prompt coordinan múltiples subagentes para tareas complejas.

Algunas de estas herramientas, como GitHub, memoria, generación de imágenes, texto a voz y checkpoints, están desactivadas por defecto. Puedes activarlas en los ajustes de OMP.

En otras palabras, el modelo puede hacer mucho más que generar código. A través de Oh My Pi puede buscar en la web, entender una base de código, editar archivos, ejecutar comandos, depurar errores, recordar el contexto del proyecto y coordinar múltiples agentes desde la misma terminal.

Crea un proyecto con Oh My Pi y Grok

En lugar de probar la configuración con una pregunta sencilla, vamos a darle un proyecto completo y ver cómo se desenvuelven Grok y Oh My Pi en planificación, implementación, pruebas e iteración.

Primero, cambia OMP al modo plan (/plan en el momento de escribir esto):

/planCon la tecnología de

Luego introduce este prompt:

Build a simple Hospital Management System in Python.

Use Streamlit for the web interface and SQLite for storing data. Keep the project lightweight and easy to run locally.

The app should let hospital staff register patients, add doctors, schedule appointments, admit and discharge patients, and view available beds.

Create a dashboard showing total patients, doctors, appointments, admitted patients, and available beds.

Use a clean sidebar for navigation, simple forms and tables, and realistic sample data.

Organize the Python code properly, create the database automatically, add basic validation, and make all CRUD operations work.

Install any required dependencies, run the application, test the main workflows, and fix any errors.Con la tecnología de

Revisa el plan

Antes de escribir código, Grok usó las herramientas integradas de OMP para investigar documentación relevante, comprobar información actual de Streamlit y del ecosistema Python, revisar los requisitos y razonar sobre cómo estructurar la aplicación.

Después generó un plan de implementación detallado por secciones. OMP hace el plan interactivo, de modo que puedes moverte entre secciones, examinar decisiones concretas y hacer cambios antes de permitir que el agente toque el proyecto.

Cuando estés conforme, aprueba el plan y deja que Grok empiece a construir.

Deja que Grok construya y pruebe la app

Tras aprobar el plan, la implementación fue sorprendentemente directa. Grok creó la estructura del proyecto, la capa de base de datos, la interfaz en Streamlit, datos de ejemplo y la funcionalidad CRUD; después instaló dependencias y probó la aplicación.

La primera versión funcional tardó menos de cinco minutos en construirse y probarse.

Aquí es donde un buen arnés de programación marca la diferencia. Grok no se limitó a generar un bloque de Python y devolvérmelo: pudo crear archivos, ejecutar la app, inspeccionar errores, corregirlos y continuar hasta que el proyecto estuvo en marcha.

Itera sobre la interfaz

La primera versión funcionaba, pero no me convencía el aspecto por defecto de Streamlit: se veía demasiado a “app estándar” de Streamlit.

Así que le indiqué al agente qué quería cambiar: tema, diseño del dashboard, jerarquía visual y cómo presentar la información. Grok modificó el proyecto existente en lugar de reconstruirlo desde cero.

El resultado final fue un sistema de gestión hospitalaria pulido, con gestión de pacientes, registro de médicos, citas, ingresos, control de camas e informes.

Este proceso también muestra el valor de los agentes de programación: puedes empezar con una versión funcional, revisarla y seguir puliendo diseño y funcionalidad con indicaciones sencillas.

Una nota sobre el coste

Hay un inconveniente importante: usar Grok vía API puede resultar caro para flujos agentivos de programación.

En este proyecto, el panel de uso de SpaceXAI mostró un gasto total de 11,84 $, con unos 19,4 millones de tokens procesados en 938 solicitudes a la API. La mayor parte se debió a planificación, búsqueda web, edición de archivos, ejecución de herramientas, pruebas de la app y refinado de la UI.

Para pruebas puntuales, los créditos de API siguen siendo útiles porque controlas exactamente cuánto gastas. Pero si programas a diario o construyes proyectos más grandes, una suscripción SuperGrok suele ser mejor opción, especialmente cuando los flujos agentivos generan cientos de peticiones en una sola sesión.

Grok ofreció resultados excelentes, pero esta prueba también mostró que, con agentes de programación, el coste y el uso de tokens importan tanto como la calidad del modelo.

Reflexiones finales

Una cosa cada vez más clara con los agentes de programación es que el modelo y el arnés no tienen por qué venir de la misma empresa. El arnés por defecto de un modelo no siempre es la mejor forma de usarlo, y cada vez más desarrolladores combinan modelos potentes como Claude o Grok con agentes alternativos y herramientas en terminal que encajan mejor con su flujo de trabajo.

El problema es que montarte tu propio setup puede volverse tedioso enseguida. Empiezas a instalar servidores MCP, añadir habilidades, configurar plugins, conectar herramientas y mantenerlo todo tú mismo.

Por eso me gusta Oh My Pi. Es un agente “con pilas incluidas” con la mayoría de estas capacidades integradas. Lo instalas, conectas tu proveedor o suscripción, eliges un modelo y te pones a programar. No tienes que pasar horas montando el agente antes de poder usarlo.

Grok funcionó muy bien con OMP y produjo una aplicación sólida, pero el coste por API fue más alto de lo esperado. Para pruebas puntuales, los créditos de API van bien. Si fuera a usar Grok a diario para programar, personalmente optaría por SuperGrok con OMP.

En definitiva, lo interesante no es solo qué empresa tiene el mejor modelo de programación, sino encontrar la mejor combinación de modelo y arnés para cómo trabajas tú realmente.