Repolode
pguso

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. 1

    安装 Node.js 18+,并将模型下载到 ./models/ 目录(详见 DOWNLOAD.md)

  2. 2

    安装依赖

    npm install
  3. 3

    运行入门示例

    node intro/intro.js
  4. 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 数据每日更新。

相关项目