一个用 JavaScript 从零实现检索增强生成(RAG)的分步教学项目,基于本地 LLM,不依赖云端 API。
pguso/ai-agents-from-scratch
一套从零构建 AI 智能体的实践教程,基于 node-llama-cpp 使用本地大模型,涵盖函数调用、记忆与 ReAct 模式。
- Star
- 4,871
- Fork
- 721
- 未关闭 Issue
- 12
- 最近提交
- 3个月前
这是什么?
AI Agents From Scratch 是一个不依赖智能体框架、用 JavaScript 从零构建 AI 智能体的学习项目。它通过 node-llama-cpp 在本地运行 GGUF 格式的模型,提示词、工具调用和循环过程都直接写在代码里,便于逐步理解底层机制。
教程由 15 个循序渐进的示例组成,内容从基础模型加载、系统提示词和流式输出,延伸到批处理、函数调用、持久化记忆、ReAct(推理与行动)循环、错误处理,以及 Tree of Thought、Graph of Thought、Chain of Thought 和基于向量嵌入的工具路由等进阶模式。每个示例目录都包含可直接运行的脚本,以及代码讲解和概念说明文档。
运行环境需要 Node.js 18 及以上版本,建议至少 8GB 内存,模型需按下载说明放入本地 models 目录。配套网站 agentsfromscratch.com 提供概念讲解,项目还有对应的 Python 版本。
核心功能
- 01通过 node-llama-cpp 运行本地 GGUF 模型,无需云端 API 密钥
- 02演示基于 JSON Schema 的工具定义与函数调用
- 03包含推理、行动、观察的 ReAct 智能体循环
- 04演示跨会话的持久化记忆,用于保存事实与偏好
- 05介绍带重试、超时和降级兜底的错误处理
- 06每个示例均附代码、逐行讲解和概念说明
适用场景
- 希望在采用 LangChain 等框架前先理解智能体底层原理的开发者
- 想用小型本地模型学习函数调用与工具使用的工程师
- 需要在 Node.js 中搭建离线或注重隐私的大模型原型的团队
- 准备智能体架构实践课程的讲师
快速上手
- 1
安装 Node.js 18+,并将模型下载到 ./models/ 目录(详见 DOWNLOAD.md)
- 2
安装依赖
npm install - 3
运行入门示例
node intro/intro.js - 4
运行简单智能体示例
node simple-agent/simple-agent.js
使用前须知
- 需要下载本地 GGUF 模型,且至少需要 8GB 内存(推荐 16GB)。
- 这是一个教程式示例项目,而非可用于生产的框架。
标签
常见问题
- ai-agents-from-scratch 是什么?
- 一套从零构建 AI 智能体的实践教程,基于 node-llama-cpp 使用本地大模型,涵盖函数调用、记忆与 ReAct 模式。 AI Agents From Scratch 是一个不依赖智能体框架、用 JavaScript 从零构建 AI 智能体的学习项目。它通过 node-llama-cpp 在本地运行 GGUF 格式的模型,提示词、工具调用和循环过程都直接写在代码里,便于逐步理解底层机制。
- ai-agents-from-scratch 可以免费使用吗?用的什么许可证?
- ai-agents-from-scratch 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- ai-agents-from-scratch 还在维护吗?
- 半年内有更新。ai-agents-from-scratch 最近一次提交是在 2026年7月24日。
- ai-agents-from-scratch 适合用来做什么?
- 希望在采用 LangChain 等框架前先理解智能体底层原理的开发者 想用小型本地模型学习函数调用与工具使用的工程师 需要在 Node.js 中搭建离线或注重隐私的大模型原型的团队 准备智能体架构实践课程的讲师
- ai-agents-from-scratch 怎么安装和运行?
- 安装 Node.js 18+,并将模型下载到 ./models/ 目录(详见 DOWNLOAD.md) 安装依赖: npm install 运行入门示例: node intro/intro.js 运行简单智能体示例: node simple-agent/simple-agent.js
- 在哪里获取 ai-agents-from-scratch?
- 源代码和安装说明在 GitHub 上:https://github.com/pguso/ai-agents-from-scratch
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
一份教你用 LangChain 和免费模型(Groq、Gemini)从零搭建 Python AI 智能体的入门教程。
一门免费开源的 AI 工程课程,共 542 节课,用 Python、TypeScript、Rust 和 Julia 从零实现核心概念。
一套带逐行注释的教程,用 Python 和 PyTorch 从零实现并训练一个类 LLaMA 架构的小型 GPT。
一个嵌入网页运行的 JavaScript GUI 智能体,可用自然语言操控页面界面。