pguso/ai-agents-from-scratch

これは何？

主な機能

• 01node-llama-cppを通じて、クラウドAPIキーなしでローカルのGGUFモデルを実行
• 02JSON Schemaによるツール定義を使ったFunction Callingを解説
• 03reason、act、observeのステップからなるReActエージェントループを紹介
• 04セッションをまたいで事実や好みを保持する永続メモリを実演
• 05リトライ、タイムアウト、フォールバックによるエラー処理を提供
• 06各サンプルにコード、行ごとの解説、概念に関する補足を収録

ユースケース

• LangChainなどのフレームワークを採用する前に、エージェントの内部動作を理解したい開発者
• 小規模なローカルモデルを使ってFunction Callingやツール利用を学ぶエンジニア
• Node.jsでオフラインまたはプライバシー重視のLLMプロトタイプを開発するチーム
• エージェントアーキテクチャの実践的な講座を準備する講師

クイックスタート

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のRAM（16GB推奨）が必要です。
• !本番環境向けのフレームワークではなく、サンプルを使ったチュートリアルです。

トピック

よくある質問

ai-agents-from-scratch とは？

node-llama-cppでローカルLLMを使い、Function Callingやメモリ、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などのフレームワークを採用する前に、エージェントの内部動作を理解したい開発者 小規模なローカルモデルを使ってFunction Callingやツール利用を学ぶエンジニア Node.jsでオフラインまたはプライバシー重視のLLMプロトタイプを開発するチーム エージェントアーキテクチャの実践的な講座を準備する講師

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