Repolode
Enviar
pguso

pguso/ai-agents-from-scratch

Tutorial práctico para crear agentes de IA desde cero con LLM locales mediante node-llama-cpp, que abarca function calling, memoria y ReAct.

Ver en GitHub
Estrellas
4,871
Forks
721
Issues abiertos
12
Último commit
hace 3 meses

¿Qué es?

AI Agents From Scratch es un repositorio didáctico para crear agentes de IA en JavaScript sin depender de frameworks de agentes. Ejecuta modelos GGUF locales mediante node-llama-cpp, para que los lectores puedan ver directamente en el código cada prompt, llamada a una herramienta e iteración del bucle, en lugar de que queden ocultos tras una capa de abstracción.

El material está organizado en 15 ejemplos secuenciales. Avanza desde la carga básica de modelos y los prompts de sistema hasta el streaming, el procesamiento por lotes y el function calling; luego aborda la memoria persistente, el ciclo ReAct de razonamiento y acción, el manejo de errores y patrones más recientes, como Tree of Thought, Graph of Thought, Chain of Thought y el enrutamiento de herramientas basado en embeddings. Cada carpeta de ejemplo incluye un script ejecutable, además de explicaciones en CODE.md y CONCEPT.md.

El proyecto requiere Node.js 18 o posterior y al menos 8 GB de RAM. Los modelos se guardan en una carpeta local llamada models, siguiendo la guía de descarga incluida. El sitio web complementario, agentsfromscratch.com, ofrece explicaciones conceptuales junto con el código, y el tutorial también se mantiene por separado en una versión para Python.

Funciones clave

  • 01Ejecuta modelos GGUF locales mediante node-llama-cpp, sin necesidad de claves de API en la nube
  • 02Aborda el function calling con definiciones de herramientas en JSON Schema
  • 03Incluye un ciclo de agente ReAct con pasos de razonamiento, acción y observación
  • 04Muestra cómo usar memoria persistente para conservar datos y preferencias entre sesiones
  • 05Ofrece manejo de errores con reintentos, tiempos de espera y alternativas
  • 06Cada ejemplo incluye el código, una explicación línea por línea y notas conceptuales

Casos de uso

  • Desarrolladores que quieren entender cómo funcionan los agentes por dentro antes de adoptar LangChain u otros frameworks similares
  • Ingenieros que están aprendiendo function calling y uso de herramientas con un modelo local pequeño
  • Equipos que crean prototipos de LLM sin conexión o con requisitos de privacidad en Node.js
  • Instructores que preparan un curso práctico sobre arquitecturas de agentes

Inicio rápido

  1. 1

    Instala Node.js 18+ y descarga los modelos en ./models/ (consulta DOWNLOAD.md)

  2. 2

    Instala las dependencias

    npm install
  3. 3

    Ejecuta el ejemplo introductorio

    node intro/intro.js
  4. 4

    Ejecuta el ejemplo de agente sencillo

    node simple-agent/simple-agent.js

Antes de usarlo

  • Es necesario descargar modelos GGUF locales y disponer de al menos 8 GB de RAM (se recomiendan 16 GB).
  • Es un tutorial con ejemplos, no un framework para producción.

Temas

#ai-agents#llm#function-calling#react-agent#local-llm#tutorial#node-llama-cpp#javascript#educational#llm-agent

Preguntas frecuentes

¿Qué es ai-agents-from-scratch?
Tutorial práctico para crear agentes de IA desde cero con LLM locales mediante node-llama-cpp, que abarca function calling, memoria y ReAct. AI Agents From Scratch es un repositorio didáctico para crear agentes de IA en JavaScript sin depender de frameworks de agentes. Ejecuta modelos GGUF locales mediante node-llama-cpp, para que los lectores puedan ver directamente en el código cada prompt, llamada a una herramienta e iteración del bucle, en lugar de que queden ocultos tras una capa de abstracción.
¿ai-agents-from-scratch es gratuito? ¿Qué licencia tiene?
ai-agents-from-scratch es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿ai-agents-from-scratch sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de ai-agents-from-scratch fue el 24 jul 2026.
¿Para qué puedo usar ai-agents-from-scratch?
Desarrolladores que quieren entender cómo funcionan los agentes por dentro antes de adoptar LangChain u otros frameworks similares Ingenieros que están aprendiendo function calling y uso de herramientas con un modelo local pequeño Equipos que crean prototipos de LLM sin conexión o con requisitos de privacidad en Node.js Instructores que preparan un curso práctico sobre arquitecturas de agentes
¿Cómo se instala ai-agents-from-scratch?
Instala Node.js 18+ y descarga los modelos en ./models/ (consulta DOWNLOAD.md) Instala las dependencias: npm install Ejecuta el ejemplo introductorio: node intro/intro.js Ejecuta el ejemplo de agente sencillo: node simple-agent/simple-agent.js
¿Dónde consigo ai-agents-from-scratch?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/pguso/ai-agents-from-scratch

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

Proyectos relacionados