Skip to main content
Odysseusは、ChatGPTやClaudeに似たプライベートなWeb体験を提供するために設計された、セルフホスト型のAIワークスペースです。ローカルモデルに対応するだけでなく、MixrouteなどのクラウドAPIともシームレスに連携し、強力なエージェントルーティング、Deep Research、ドキュメントの共同編集、永続メモリ（ChromaDB）、進化するスキルシステムを備えています。

​
主な機能

スマートなエージェントルーティング

ツール呼び出し、ウェブ検索、ファイルの読み書き、Shell実行に基づく自律型エージェントを内蔵し、MCPサービスによる拡張に対応しています。

Deep Research

学術情報や事実情報の検索、統合、抽出を複数ステップで自律的に行い、最終的に包括的で高品質なビジュアルレポートを出力します。

セルフホスト型のAIコラボレーション

AIがコンテキストに基づいてドキュメントを共同編集できるリッチテキストMarkdownエディターを搭載し、モバイルデバイス向けに最適化されています。

​
前提条件

デプロイを始める前に、システムが以下の要件を満たしていることを確認してください。
1

Mixrouteの認証情報を準備

スマートルーティングは、タスクの複雑さに応じてリクエストを最適なモデルに自動的に振り分け、APIコストを削減しながら効率を高める、インテリジェントなモデルルーティング機能です。
  1. Mixroute APIのエンドポイントURLを取得します。通常はhttps://api.mixroute.ai/v1です
  2. Mixrouteのスマートルーティングページで、スマートルーティングのノードキーを生成します。
  3. タスクのレベルごとにモデルを選択します。制約と利用ガイドについては、スマートルーティングガイドを参照してください。
設定例:
2

環境の依存関係の確認

  • Dockerでのデプロイ：DockerとDocker Composeが必要です。
  • Linuxへのネイティブデプロイ：Python 3.11以上が必要です。また、システムにgitがインストールされていることを確認してください。

​
Odysseusのデプロイ

システム構成に応じて、推奨されるDockerコンテナでのデプロイか、Linuxへのネイティブデプロイを選択できます。
Docker Composeを使用し、1つのコマンドでOdysseusと付随するサービス（ChromaDB、SearXNGなど）を起動します。すべてのデータはローカルのdata/ディレクトリに永続化されます。
任意のPDFレンダリングとOffice文書の抽出機能（AGPLのPyMuPDFが必要）を利用する場合は、upを実行する前に、ビルド引数を指定して手動でビルドしてください。

​
初回ログインとパスワードの取得

デフォルトでは、Odysseusは初回起動時に管理者アカウントadminを自動作成し、生成したランダムな初期パスワードを起動ログに出力します。
1

初期管理者パスワードの取得

ターミナルで次のコマンドを実行し、出力を確認してください。
  • Dockerでのデプロイ：
  • Linuxへのネイティブデプロイ: uvicornまたは起動したターミナルに出力される一時的な初期パスワードを確認してください。
2

Webコンソールにアクセスする

ユーザー名adminと、先ほど取得したパスワードでログインしてください。
  • ローカルアクセス: http://127.0.0.1:7000
  • リモートのクラウドサーバーへのアクセス：http://<your-server-ip>:7000
デフォルトでは、コンテナは127.0.0.1でのみ待ち受けます。クラウド仮想マシンを設定する必要がある場合は、以下のネットワークエラーまたはコンテナの待ち受けに関する問題を参照してください。

​
Mixrouteの設定

ログインに成功したら、以下の手順でMixrouteをカスタムエンドポイントとして設定し、Odysseusのインテリジェントアシスタントで利用します。
1

設定パネルを開く

左下の設定をクリックして、システム全体の設定にアクセスします。Odysseusの設定
2

プロバイダーの設定

設定のProviders/Endpointsページで、新しいカスタムエンドポイントを追加します。
  • ベースURL: https://api.mixroute.ai/v1
  • APIキー: Mixroute APIキーを入力してください（例: sk-xxxxxxxx） Odysseus プロバイダーの追加
3

モデルの有効化と管理

エンドポイントを追加すると、Odysseusは自動的に接続を確認し、そのエンドポイントが返す利用可能なモデルを読み込みます。一覧でよく使うモデルを有効にすることも、グローバルなデフォルトの役割（デフォルトのチャット、Deep Research、タスクスケジューリング、画像認識など）に割り当てることもできます。
テストでは、GPTシリーズがOdysseusで特に優れた性能を示しています。GPTモデルと組み合わせて使用することを強くおすすめします。
Odysseus モデルの有効化
4

Odysseusをお楽しみください

チャットのホームページに戻り、会話を開始したり、Mixrouteの基盤モデルを利用する強力なインテリジェントエージェントを起動したりできます。Odysseus 設定完了

​
よくある質問と詳細設定

セルフホスト型コンテナ内のCookbookからローカルGPUを呼び出したり管理したりする場合は、以下をお勧めします。
  1. 組み込みの診断・設定スクリプトを実行します。
  2. このスクリプトは、.envにCOMPOSE_FILE=docker-compose.yml:docker/gpu.nvidia.ymlを自動的に追加し、NVIDIA Container Toolkitのマッピングを有効にします。
デフォルトでは、コンテナは127.0.0.1でのみ待ち受けます。
  • LANまたはパブリックネットワーク経由でIPアドレスを使って直接アクセスする必要がある場合は、.env内のAPP_BIND=0.0.0.0を変更し、コンテナを再起動してください。
  • 本番環境では、リッスンアドレスを127.0.0.1のままにし、Nginx、Caddy、またはCloudflare TunnelをSSL証明書付きのリバースプロキシとして使用することを強くおすすめします。
ChromaDBの読み込みに失敗する、またはクライアントの互換性の問題が発生する場合：
設定が完了すると、Odysseusの以降のすべての機能（Deep Research、ファイル検索、カレンダーとToDo、メールの仕分け）は、設定画面で関連付けて設定したMixrouteエンドポイントによって動作し、堅牢で費用対効果の高いクラウドベースのLLM体験を提供します。