SaladDay/pi-from-scratch

これは何？

主な機能

• 01ファイルの読み取り、コードの編集、シェルコマンドの実行ができるコーディングエージェントを構築します。
• 02piのデータフローに沿い、中核となる設計思想だけに絞っています。
• 03記事の内容と、エディター内で段階的に埋まっていくソースコードを組み合わせています。
• 04ブレークポイントを設定してコードの実行を順に確認できる、トレースビューアーを備えています。
• 05環境変数を使って、OpenAI互換APIならどれでも利用できます。

ユースケース

• コーディングエージェントのループ、ツール呼び出し、ファイル編集が内部でどう動くかを学ぶ。
• piを詳しく学ぶ前に、土台となる小規模なエージェントを自作する。
• ワークショップや講座でエージェントのアーキテクチャを教える。

クイックスタート

1. 1

   Node.js 22以降をインストールし、OpenAI互換のAPIキーを取得します

2. 2

   依存関係をインストールします

   npm install
3. 3

   APIキーを設定します

   export NANOPI_API_KEY=your-api-key
4. 4

   プロジェクトを起動します

   npm run dev

使う前に知っておきたいこと

• !エージェントの実行にはOpenAI互換のAPIキーが必要です。

Repolode 週刊で紹介

• 第 2 号 · エージェント向けRust製ヘッドレスブラウザと型付きSQLインポート

  ファイルを読み、コードを編集し、コマンドを実行できる最小限のコーディングエージェントをTypeScriptでゼロから作るチュートリアルです。piのデータフローに沿って核となる設計だけを残し、本文の横でソースが少しずつ埋まっていきます。

収録されている特集

トピック

よくある質問

pi-from-scratch とは？

ファイルの読み取り、コードの編集、コマンドの実行ができる最小限のTypeScript製コーディングエージェントを、一から構築するステップ形式のチュートリアル。 PI from Scratchは、約600行のTypeScriptでpiコーディングエージェントの中核となる考え方を再現する、実践的なチュートリアルです。この実装はnano-piと呼ばれます。piのデータフローに沿って、各コンポーネントを理解に必要な範囲だけ実装し、本番運用向けのエンジニアリング上の詳細は省いています。

pi-from-scratch は無料で使えますか？ライセンスは？

pi-from-scratch は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

pi-from-scratch は今もメンテナンスされていますか？

活発にメンテナンス中。pi-from-scratch の最終コミットは 2026年10月24日 です。

pi-from-scratch は何に使えますか？

コーディングエージェントのループ、ツール呼び出し、ファイル編集が内部でどう動くかを学ぶ。 piを詳しく学ぶ前に、土台となる小規模なエージェントを自作する。 ワークショップや講座でエージェントのアーキテクチャを教える。

pi-from-scratch のインストール方法は？

Node.js 22以降をインストールし、OpenAI互換のAPIキーを取得します 依存関係をインストールします: npm install APIキーを設定します: export NANOPI_API_KEY=your-api-key プロジェクトを起動します: npm run dev

pi-from-scratch はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/SaladDay/pi-from-scratch