初めてのAIセットアップ

Odysseus AI をまだインストールしていない人は、まず公式GitHubリポジトリを確認し、Docker、Windowsネイティブ、macOSネイティブ、API連携のいずれかのセットアップ方法を選びます。

Docker または Ollama の設定

Docker や Ollama のセットアップが必要な場合、ポート問題、.env ファイル、コンテナの状態、Ollama エンドポイントのマッピング問題を解決するのに役立ちます。

壊れたインストールのトラブルシューティング

すでに Odysseus AI が動かない場合、エラーの種類（管理者パスワード、localhost:7000、Docker Compose、Ollama、PowerShell、GPU、APIキー）を分類し、`docker compose ps` などの安全な診断コマンドを実行します。

公式ソースの確認

偽のダウンロードページや悪意のあるミラーサイトを避けるため、公式GitHubリポジトリ（pewdiepie-archdaemon/odysseus）を使っているか確認できます。

localhost-first の実践

ポートやAPIキーを外部に公開せず、ローカルでAIツールを実行する方法を学べます。

自分に合ったセットアップ経路の取得

いくつかの質問に答えるだけで、おすすめのインストール方法（Docker Compose、Windowsネイティブ、Apple Siliconネイティブ、API連携、またはトラブルシューティング優先）と、最初に実行すべきコマンドが提示されます。

公式ソースの確認

クローンやダウンロードをする前に、必ず公式GitHubリポジトリを確認します。偽のチュートリアルやランダムなインストーラーファイルを避けるためです。

セットアップ経路チェッカー

いくつかの質問に答えると、おすすめのインストール経路と最初に実行するコマンドが表示されます。

Docker & Ollama 対応

Docker と Ollama に対応しており、Docker からホストへのエンドポイント問題（例：http://host.docker.internal:11434/v1）を解決するガイドも用意されています。

エラードクターツール

エラーの種類（管理者パスワード、localhost:7000、Docker Compose、Ollama、PowerShell、GPU、APIキー）を分類し、`docker compose ps` などの安全な診断コマンドを実行できます。

localhost-first のセキュリティ

ポートやAPIキーを外部に公開せず、すべてをローカルマシン上で実行します。

マルチプラットフォーム対応

Windows、Mac、Linux で動作し、Windows と Apple Silicon 向けのネイティブセットアップも用意されています。

無料＆オープンソース

ソースコードは無料で、サイトはインストールのショートカットやツールを提供するだけです。

モデル連携

Odysseus はあくまでインターフェースです。Ollama や他のモデルプロバイダーと接続してAIモデルを実行します。