【初心者向け】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・フォローいただけると励みになります！