Odysseus AI macOS設定：Mac・MacBook・Apple SiliconとOllama

確認したいことに合わせてMacの設定経路を選ぶ

MacBookやiMacでローカルモデルとOllamaを使うなら、Apple Siliconのnative経路が最初の選択として分かりやすいです。Dockerは隔離や再現性に向きますが、localhostの意味を変えるネットワーク層が増えます。

Odysseus AIとOllamaをMacでnative実行するならlocalhostを使います。Odysseus AIがDocker、OllamaがMacホストならhost.docker.internalを使います。ポートやモデルtagを変える前に経路を決めてください。

git clone https://github.com/odysseus-dev/odysseus.git
cd odysseus
./start-macos.sh

Apple SiliconでOdysseus AIをネイティブ設定する

nativeのmacOS経路は、ローカルモデルを使うMacBookやiMacにとって直接的な設定です。Ollamaや別providerを追加する前に、repository、launcher権限、Pythonと依存関係、最初のlocal URLを確認します。

初回起動ではworkspaceが正常であることを確認します。ポート競合や依存関係エラーをモデル設定で隠さないようにします。

1. 公式リポジトリをcloneする

setup script、issue、README変更は公式リポジトリを基準にします。

git clone https://github.com/odysseus-dev/odysseus.git
cd odysseus

2. macOS launcherを実行し最初のエラーを読む

最初のエラーは権限、Python、依存関係、ポート競合を示すことが多いです。

chmod +x ./start-macos.sh
./start-macos.sh

3. ローカルUIを開いて初回ログインを完了する

指定ポートで起動したらそのURLを開き、一時認証情報を更新します。

http://127.0.0.1:7860

4. モデル設定はその後に行う

workspaceが正常になってからSettingsでOllamaなどを接続します。

http://127.0.0.1:11434/v1

MacのDocker：隔離とローカルモデル接続の違い

Dockerは、使い捨てのテスト、依存関係の分離、デプロイに近い再現性が必要なmacOS設定で役立ちます。ただしApple Siliconでローカルモデルを使う場合の標準解とは限りません。

コンテナからMacホストのOllamaへ到達する場合はhost endpointを使い、container内のlocalhostがMacを指すとは考えないでください。最初はlocalのまま確認します。

Odysseus AIのMac設定でOllamaを接続する

Ollamaは独立したローカルモデルサーバーです。同じMacでOdysseus AIとOllamaをnative実行するなら http://127.0.0.1:11434/v1、Odysseus AIがDockerでOllamaがMacホストなら http://host.docker.internal:11434/v1 を使います。

Odysseus AIのUIを調べる前に、Ollamaとモデル一覧を確認します。Macのworkspaceが起動してもprovider endpointやモデルtagが間違っている場合があります。

http://127.0.0.1:11434/v1

MacBook・iMac・macOSでOdysseus AIを切り分ける

まずlauncherとlocal UI、次にruntime network、最後にOllamaとモデルtagを確認します。Macの起動問題とprovider問題を分けて考えられます。

Macインストールの最終チェック

Macセットアップは、workspace、model endpoint、安全境界が明確になってから本格検証に進めます。

1. クリーン起動後にローカルUIが開く。
2. native、Docker、remoteのどれかを把握している。
3. Odysseus AIの前にOllama単体で応答する。
4. agentやdocument前に小さいモデルが動く。
5. ルールなしにworkspaceをネットワーク公開していない。

2026年版：Odysseus AI macOS設定の確認メモ

Macではworkspaceとモデルruntimeをどこで動かすかが中心です。Apple Siliconのnativeはnetwork層を一つ減らし、Dockerは隔離できますがhost accessが変わります。

MacBookやiMacでは、workspace起動、local UI確認、Ollama確認、runtimeに合うendpoint選択、モデルrequestの順に進めます。

1. この追加セクションは、読者が Docker、ネイティブ実行、Ollama エンドポイントを混同しないようにするための更新です。
2. 2026年の検証メモを追加し、公式ソース、ローカル実行、Ollama 連携、関連ガイドへの導線を明確にしました。
3. このページの意図を、関連するセットアップガイドと分けてください。