Repolode
SaladDay

SaladDay/pi-from-scratch

Tutorial paso a paso para crear desde cero un agente de programación mínimo en TypeScript que puede leer archivos, editar código y ejecutar comandos.

Estrellas
1,301
Forks
108
Issues abiertos
0
Último commit
hace 13 días

¿Qué es?

PI from Scratch es un tutorial práctico que reconstruye las ideas centrales del agente de programación pi en unas 600 líneas de TypeScript, bajo el nombre nano-pi. Sigue el flujo de datos de pi e implementa cada componente solo hasta donde hace falta para entenderlo, sin incluir detalles de ingeniería de producción.

El proyecto se presenta como un artículo fácil de seguir acompañado del código fuente. En el sitio web complementario, el código del editor se completa progresivamente a medida que lees, y una función de trazas te permite recorrer la ejecución línea por línea con puntos de interrupción. El agente funciona con cualquier API compatible con OpenAI y se configura mediante variables de entorno para indicar la clave de API, el nombre del modelo y la URL base.

Las trazas en línea son datos estáticos pregenerados, por lo que navegar por el sitio no genera solicitudes al modelo. Para ejecutar nano-pi localmente se necesita Node.js 22 o posterior.

Funciones clave

  • 01Crea un agente de programación que lee archivos, edita código y ejecuta comandos de shell.
  • 02Sigue el flujo de datos de pi y conserva solo las ideas centrales de diseño.
  • 03Combina el texto del artículo con código fuente que se completa progresivamente en el editor.
  • 04Incluye un visor de trazas para recorrer la ejecución del código con puntos de interrupción.
  • 05Funciona con cualquier API compatible con OpenAI mediante variables de entorno.

Casos de uso

  • Aprender cómo funcionan internamente el ciclo de un agente de programación, las llamadas a herramientas y la edición de archivos.
  • Crear tu propio agente pequeño como base antes de estudiar pi en profundidad.
  • Enseñar arquitectura de agentes en un taller o curso.

Inicio rápido

  1. 1

    Instala Node.js 22 o una versión posterior y consigue una clave de API compatible con OpenAI

  2. 2

    Instala las dependencias

    npm install
  3. 3

    Configura tu clave de API

    export NANOPI_API_KEY=your-api-key
  4. 4

    Inicia el proyecto

    npm run dev

Antes de usarlo

  • Para ejecutar el agente, se necesita una clave de API compatible con OpenAI.

Destacado en Repolode Weekly

En colecciones

Temas

Preguntas frecuentes

¿Qué es pi-from-scratch?
Tutorial paso a paso para crear desde cero un agente de programación mínimo en TypeScript que puede leer archivos, editar código y ejecutar comandos. PI from Scratch es un tutorial práctico que reconstruye las ideas centrales del agente de programación pi en unas 600 líneas de TypeScript, bajo el nombre nano-pi. Sigue el flujo de datos de pi e implementa cada componente solo hasta donde hace falta para entenderlo, sin incluir detalles de ingeniería de producción.
¿pi-from-scratch es gratuito? ¿Qué licencia tiene?
pi-from-scratch es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿pi-from-scratch sigue mantenido?
Mantenimiento activo. El último commit de pi-from-scratch fue el 24 oct 2026.
¿Para qué puedo usar pi-from-scratch?
Aprender cómo funcionan internamente el ciclo de un agente de programación, las llamadas a herramientas y la edición de archivos. Crear tu propio agente pequeño como base antes de estudiar pi en profundidad. Enseñar arquitectura de agentes en un taller o curso.
¿Cómo se instala pi-from-scratch?
Instala Node.js 22 o una versión posterior y consigue una clave de API compatible con OpenAI Instala las dependencias: npm install Configura tu clave de API: export NANOPI_API_KEY=your-api-key Inicia el proyecto: npm run dev
¿Dónde consigo pi-from-scratch?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/SaladDay/pi-from-scratch

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados