【初心者向け】GraphAIをWindowsで動かすまでの全手順（Node.js + OpenAI API）
こんにちは、大企業・中小企業・SE・営業・経営を経験し、現在は製造業を中心にデジタル化、DX支援などをしておりますせいやです。
最近話題の GraphAI を、実際に Windows環境で動かしてみたので、その手順をまとめました。
この投稿を読めば、あなたのWindowsでもChatGPTと対話できるAIボットが動くようになります！
✅ この記事でわかること
- GraphAIとは何か（ざっくり）
- GraphAIをWindows + Node.jsで動かす手順
- 「こんにちは」と入力→ChatGPTの返答が返ってくる構成まで
- よくあるエラーとその対処法（初心者でもつまずかない）
1. GraphAIとは？
GraphAIは、Receptron社が開発しているエージェントベースのAIフレームワークです。
- ノード同士をグラフ構造でつなぎ処理を定義
- エージェント（ChatGPTや関数）をつなげて柔軟なワークフローを実現
- 条件分岐やループも構築できるため、RAG構造や業務フローに応用しやすい
簡単に言えば、ChatGPTや関数処理を組み合わせて、自分だけのAIオートメーションが作れるすごいやつです。
2. 動作環境
- Windows 10 / 11
- Node.js（18以上推奨）
- OpenAI APIキー（
gpt-4oなど）
3. セットアップ手順
Node.js のインストール
以下からインストーラーをダウンロードして、LTS版をインストールします。
👉 https://nodejs.org/ja
インストール後、バージョン確認：
node -v
npm -v
② プロジェクトフォルダ作成
mkdir graphai-test
cd graphai-test
npm init -y
③ .env ファイルの作成（APIキー）
プロジェクト直下に .env ファイルを作成し、以下を記述：
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
④ 必要パッケージのインストール
npm install node-fetch dotenv
4. 最小構成の GraphAI 対話ボットを作成
chat.mjs の作成
import readline from 'readline';
import 'dotenv/config';
const fetch = (...args) => import('node-fetch').then(({ default: fetch }) => fetch(...args));
const rl = readline.createInterface({
input: process.stdin,
output: process.stdout
});
function promptUser() {
rl.question('👤 あなた: ', async (input) => {
if (input.toLowerCase() === 'exit') {
console.log('👋 終了します！');
rl.close();
return;
}
const res = await fetch('https://api.openai.com/v1/chat/completions', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
Authorization: `Bearer ${process.env.OPENAI_API_KEY}`
},
body: JSON.stringify({
model: 'gpt-4o',
messages: [
{ role: 'system', content: 'あなたは親切なアシスタントです。' },
{ role: 'user', content: input }
]
})
});
const json = await res.json();
const reply = json.choices?.[0]?.message?.content ?? 'GPTの応答に失敗しました。';
console.log(`🤖 GPT: ${reply}\n`);
promptUser();
});
}
promptUser();
実行方法
node chat.mjs
試しに こんにちは と入力してみてください。
GPTが返答してくれるはずです。
5. ハマりポイントとその対処法
| ハマりポイント | 解決策 |
|---|---|
fetch is not a function |
Node.jsでは標準搭載されていないため node-fetch を import()で読み込む |
.env が読み込まれない |
dotenv/config を import して読み込み |
chat.js で動かない |
.mjs 拡張子で作成する（ESM構文） |
input is not defined |
rl.question() の中で input を使うように構成する |
6. GraphAI そのものを使いたい人へ
GraphAI はまだnpm登録されていないため、GitHubからクローンする形になります：
git clone https://github.com/receptron/graphai.git
cd graphai
npm install
サンプルが豊富なので、まずは examples を眺めてみるのがオススメです。
まとめ
- GraphAIは「エージェント思考」でAIワークフローを組める画期的な仕組み
- Windows + Node.jsでもサクッと動かせる
- ChatGPTと組み合わせて、CSVやAPI連携まで応用可能
今後やってみたいこと
- CSVで商品の在庫データを読み込んで、GPTに在庫回答をさせる
- GraphAIで社内問い合わせBotを構築
- GraphAI + Notion / Slack連携 などの業務自動化
参考リンク
以上です！
「自分だけのAIアシスタントを作ってみたい」
「AIを業務に組み込みたい」
という方は、ぜひチャレンジしてみてください！
※ご質問・コメントもお気軽にどうぞ。もしこの記事が参考になったら LGTM・フォローいただけると励みになります！