ローカルAIエージェントセットアップ手順

MacBook Pro M2 / macOS 対象
所要時間の目安：30〜60分（モデルのダウンロード込み）

事前準備：ファイルの入手

以下のファイルをあらかじめホームディレクトリ（~）に用意してください。

ファイル名	説明
`app.py`	Flask製のWebアプリ本体
`build_knowledge.py`	知識DBを構築するスクリプト
`start_ai.command`	ダブルクリックで起動するランチャー

ステップ 1：Homebrew のインストール

1-1. すでに入っているか確認

bash（ターミナルで以下を入力）
brew --version

バージョン番号が表示されればインストール済みです。→ ステップ 2 へ進む

1-2. インストールされていない場合

bash（ターミナルで以下を入力）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

1-3. ⚠️ Apple Silicon（M1/M2/M3）は PATH の設定が必要

インストール後、ターミナルに以下を入力してください。

bash（ターミナルで以下を入力）
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc

設定が反映されたか確認：

bash（ターミナルで以下を入力）
brew --version

ステップ 2：Python 3.11 のインストール

2-1. Python 3.11 をインストール

bash（ターミナルで以下を入力）
brew install python@3.11

2-2. ⚠️ PATH を通す

bash（ターミナルで以下を入力）
echo 'export PATH="/opt/homebrew/opt/python@3.11/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

確認：

bash（ターミナルで以下を入力）
python3.11 --version

Python 3.11.x と表示されればOKです。

ステップ 3：仮想環境の作成

bash（ターミナルで以下を入力）
python3.11 -m venv ~/myai-env311
source ~/myai-env311/bin/activate

アクティブになると、ターミナルの先頭に (myai-env311) と表示されます。

注意： ターミナルを開き直すたびに source ~/myai-env311/bin/activate が必要です。

ステップ 4：必要なライブラリのインストール

仮想環境がアクティブな状態で実行してください。

bash（ターミナルで以下を入力）
pip install mlx-lm chromadb sentence-transformers
pip install ddgs
pip install flask

ステップ 5：プロフィールファイルの作成

5-1. profile.txt を作成

テキストエディタで ~/profile.txt を作成します。
内容は ChatGPT などで自分のプロフィールを作成してもらい、以下のような形式にまとめてください。

# アカウント名プロフィール

## 基本情報
- 名前：アカウント名
- 生年：1980年代
- 居住：東京
- 年齢：40代
- 応答スタイルの好み：やや落ち着いたトーン、日本語

## 仕事・活動
- 高齢者施設で介護の仕事をしている
（以下、自分の活動・思想・技術プロジェクトなど自由に記述）

ヒント： profile.txt を育てていくことで、AIが自分をより深く理解するようになります。

5-2. knowledge フォルダにもコピー

bash（ターミナルで以下を入力）
cp ~/profile.txt ~/knowledge/profile.txt

ステップ 6：ナレッジベースの準備

6-1. knowledge フォルダを作成

bash（ターミナルで以下を入力）
mkdir -p ~/knowledge

6-2. テキストファイルを追加（任意）

記事・メモ・日記など、AIに覚えさせたい内容を .txt 形式で ~/knowledge/ に入れてください。

6-3. 知識DBを構築

⚠️ 実行前に仮想環境がアクティブか確認してください（source ~/myai-env311/bin/activate）

bash（ターミナルで以下を入力）
python ~/build_knowledge.py

~/knowledge_db/ が作成されれば成功です。

ステップ 7：起動ランチャーに実行権限を付与

start_ai.command をダブルクリックで起動するために、初回だけ以下を実行してください。

bash（ターミナルで以下を入力）
chmod +x ~/start_ai.command

ステップ 8：AIエージェントの起動

初回起動時の注意

初回はモデル（Qwen2.5-7B、約 5GB）が自動でダウンロードされます
M2 MacBook Pro（8GB）はメモリがギリギリのため、他のアプリをすべて閉じてから起動してください
ダウンロードには回線速度によって10〜30分程度かかります

起動方法

start_ai.command をダブルクリックするか、ターミナルで以下を実行：

bash（ターミナルで以下を入力）
source ~/myai-env311/bin/activate
python ~/app.py

ブラウザでアクセス

起動後、ブラウザで以下のURLを開いてください：

http://localhost:5000

ファイル・ディレクトリ一覧

ホームディレクトリに置くファイル

~/
├── app.py               # Webアプリ本体
├── build_knowledge.py   # 知識DB構築スクリプト
├── profile.txt          # 自分のプロフィール
└── start_ai.command     # 起動ランチャー

自動で作成されるディレクトリ・ファイル

~/
├── myai-env311/         # Python仮想環境
├── knowledge/           # 知識テキストの格納場所
│   └── profile.txt      # （手動でコピー）
├── knowledge_db/        # ChromaDB（自動生成）
├── chat_sessions/       # チャット履歴（自動生成）
└── chat_history.json    # チャット履歴ファイル（自動生成）

よくあるトラブル

症状	対処
`brew: command not found`	ステップ 1-3 の PATH 設定を行う
`python3.11: command not found`	ステップ 2-2 の PATH 設定を行う
`(myai-env311)` が表示されない	`source ~/myai-env311/bin/activate` を実行する
起動が重い・落ちる	他のアプリをすべて閉じてから再起動する
`localhost:5000` が開かない	`app.py` が起動しているか確認する

モデルについて

Qwen2.5-7B-Instruct-4bit を使用しています。

日本語対応が良好
4bit量子化で約 5GB
M2（8GB）でギリギリ動作

メモリに余裕がある場合は他のモデルに変更しても構いません。

myai ダウンロード

「あなたのお名前」のところは適宜入力し直してください。

⚠️ご注意⚠️

何か問題があっても当方一切責任は取りません、自己責任でご利用ください。

ローカルAIエージェント セットアップ手順