Repolode
Предложить
pguso

pguso/ai-agents-from-scratch

Практическое руководство по созданию AI-агентов с нуля на локальных LLM через node-llama-cpp: function calling, память и ReAct.

Открыть на GitHub
Звёзды
4,871
Форки
721
Открытые issues
12
Последний коммит
3 месяца назад

Что это?

AI Agents From Scratch — учебный репозиторий по созданию AI-агентов на JavaScript без агентских фреймворков. Он запускает локальные модели GGUF через node-llama-cpp, поэтому читатели могут видеть в коде каждый промпт, вызов инструмента и итерацию цикла, а не полагаться на скрытые за абстракциями детали.

Материал состоит из 15 последовательных примеров. Они охватывают путь от базовой загрузки модели и системных промптов до потоковой генерации, пакетной обработки и function calling, а затем переходят к долговременной памяти, циклу рассуждения и действий ReAct, обработке ошибок и более новым подходам, таким как Tree of Thought, Graph of Thought, Chain of Thought и маршрутизация инструментов на основе эмбеддингов. В каждой папке с примером есть запускаемый скрипт, а также пояснения в файлах CODE.md и CONCEPT.md.

Для проекта нужны Node.js 18+ и не менее 8 ГБ оперативной памяти. Модели размещаются в локальной папке models; инструкция по их загрузке входит в репозиторий. На сайте agentsfromscratch.com есть дополнительные пояснения к концепциям, а версия руководства на Python поддерживается отдельно.

Ключевые возможности

  • 01Запускает локальные модели GGUF через node-llama-cpp без ключей облачных API
  • 02Разбирает function calling с описанием инструментов в формате JSON Schema
  • 03Включает цикл агента ReAct с этапами рассуждения, действия и наблюдения
  • 04Показывает, как сохранять факты и предпочтения между сессиями
  • 05Предусматривает обработку ошибок с повторными попытками, тайм-аутами и запасными вариантами
  • 06Каждый пример включает код, построчное объяснение и заметки о концепциях

Сценарии использования

  • Разработчики, которые хотят разобраться во внутреннем устройстве агентов до перехода на LangChain или похожие фреймворки
  • Инженеры, изучающие function calling и использование инструментов с небольшой локальной моделью
  • Команды, создающие офлайн-прототипы на LLM в 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 и иметь не менее 8 ГБ оперативной памяти (рекомендуется 16 ГБ).
  • Это учебное руководство с примерами, а не фреймворк для продакшена.

Темы

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

Частые вопросы

Что такое ai-agents-from-scratch?
Практическое руководство по созданию AI-агентов с нуля на локальных LLM через node-llama-cpp: function calling, память и ReAct. AI Agents From Scratch — учебный репозиторий по созданию AI-агентов на JavaScript без агентских фреймворков. Он запускает локальные модели GGUF через node-llama-cpp, поэтому читатели могут видеть в коде каждый промпт, вызов инструмента и итерацию цикла, а не полагаться на скрытые за абстракциями детали.
ai-agents-from-scratch можно использовать бесплатно? Какая у него лицензия?
ai-agents-from-scratch распространяется с открытым исходным кодом под лицензией MIT. Перед использованием в коммерческих продуктах проверьте условия лицензии.
ai-agents-from-scratch всё ещё поддерживается?
Обновлялся за последние 6 месяцев. Последний коммит в ai-agents-from-scratch — 24 июл. 2026 г..
Для чего можно использовать ai-agents-from-scratch?
Разработчики, которые хотят разобраться во внутреннем устройстве агентов до перехода на LangChain или похожие фреймворки Инженеры, изучающие function calling и использование инструментов с небольшой локальной моделью Команды, создающие офлайн-прототипы на LLM в 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

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты