Manual comunitario no oficial en chino para el entorno de terminal Pi Coding Agent, desde la instalación hasta Skills, Extensions, Subagents y flujos de trabajo prolongados.
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
Instala Node.js 22 o una versión posterior y consigue una clave de API compatible con OpenAI
- 2
Instala las dependencias
npm install - 3
Configura tu clave de API
export NANOPI_API_KEY=your-api-key - 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
- Número 2 · Un navegador headless en Rust para agentes y SQL tipado en TypeScript
Tutorial paso a paso para construir desde cero un agente de código mínimo en TypeScript que lee archivos, edita código y ejecuta comandos. Sigue el flujo de datos de pi quedándose con lo esencial, y el código se va completando junto al texto.
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
Tutorial bilingüe y recorrido por el código fuente del SDK Pi-Agent, con código complementario y una skill para asistentes de IA que crean agentes.
Aplicación de escritorio para macOS, Windows y Linux que ofrece Pi, el agente de programación con IA, como aplicación instalable con una ventana de chat integrada.
Una aplicación web autoalojada y diseñada primero para móviles, que permite ejecutar agentes de programación Pi desde el teléfono o el navegador, con sesiones que sobreviven a los reinicios del servidor.
Control remoto del agente de programación de terminal pi: refleja sesiones en tiempo real en un navegador o teléfono y permite enviar mensajes o comandos a través de un relay autohospedado.
Curso basado en proyectos que enseña a crear el entorno, el estado, la verificación y los mecanismos de control que hacen fiables a los agentes de programación con IA.