はじめに - 5分でスタート

このガイドでは、MixSeek-Coreを使って5分以内に最初のニュース検索を実行する方法を説明します。

前提条件

uv がインストール済み - Pythonパッケージマネージャー（Pythonバージョン管理機能内蔵）
ターミナル/コマンドプロンプトが使える

uvのインストール

uvは高速なPythonパッケージマネージャーで、Python本体のバージョン管理も行います。必要なPythonバージョンはuvが自動的にダウンロード・管理します。

macOS / Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows (PowerShell):

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

パッケージマネージャー経由:

# macOS (Homebrew)
brew install uv

# Windows (WinGet)
winget install --id=astral-sh.uv -e

# pipx経由（既存のPython環境がある場合）
pipx install uv

詳細は uv公式インストールガイドを参照してください。

mixseek-coreのインストール

方法1: CLIツールとしてインストール（推奨）

グローバルにmixseekコマンドを使えるようにします：

# uvを最新版にアップデート
uv self update

# CLIツールとしてインストール（必要なPythonバージョンも自動的にダウンロードされます）
uv tool install git+https://github.com/mixseek/mixseek-core.git

# コマンドが使えることを確認
mixseek --version

以降、仮想環境を有効化せずにmixseekコマンドが使えます。

方法2: Pythonパッケージとしてインストール

プログラムから使用するライブラリとしてインストール：

# pipを使用
pip install git+https://github.com/mixseek/mixseek-core.git

# uvを使用
uv pip install git+https://github.com/mixseek/mixseek-core.git

# プロジェクト依存関係に追加（uv）
uv add git+https://github.com/mixseek/mixseek-core.git

重要: 方法2のuvでインストールした場合、コマンド実行時にuv runプレフィックスが必要です（例: uv run mixseek init）。本ガイドでは方法1を前提に説明します。

ステップ1: ワークスペースの初期化

MixSeekのワークスペースを作成します。ワークスペースには、設定ファイルとログが保存されます。

mixseek init --workspace $HOME/mixseek-workspace

注意: 方法2でインストールした場合はuv run mixseek init ...としてください。

実行結果:

Workspace initialized successfully at: /Users/username/mixseek-workspace
Created directories: 6
Created files: 7

補足: MIXSEEK_WORKSPACE 環境変数を設定すると、各コマンドで --workspace オプションの指定が不要になります。
export MIXSEEK_WORKSPACE=$HOME/mixseek-workspace
mixseek init  # --workspace オプション不要

初期化により、以下のファイルが作成されます：

mixseek-workspace/
├── configs/
│   ├── search_news.toml                       # シンプルなニュース検索設定
│   ├── search_news_multi_perspective.toml     # 多視点ニュース検索設定
│   ├── agents/
│   │   ├── team_general_researcher.toml       # 汎用調査チーム
│   │   ├── team_sns_researcher.toml           # SNS特化チーム
│   │   └── team_academic_researcher.toml      # 学術特化チーム
│   ├── evaluators/
│   │   └── evaluator_search_news.toml         # 評価設定
│   └── judgment/
│       └── judgment_search_news.toml          # 判定設定
├── logs/                                       # ログファイル保存先
└── templates/                                  # カスタムテンプレート保存先

ステップ2: API認証の設定

Google Gemini APIまたはVertex AIの認証情報を設定します。

オプションA: Gemini Developer API（個人・プロトタイピング向け）

export GOOGLE_API_KEY=your-api-key

APIキーの取得方法については Gemini API 公式ドキュメントを参照してください。

オプションB: Vertex AI（エンタープライズ向け）

export GOOGLE_GENAI_USE_VERTEXAI=true
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/gcp_credentials.json

GCPサービスアカウントのクレデンシャルファイルを指定してください。

ステップ3: 最初のニュース検索を実行

すぐに使える設定ファイルを使って、ニュース検索を実行します。

mixseek exec \
  --workspace $HOME/mixseek-workspace \
  --config configs/search_news.toml \
  "ソフトバンクのニュースを調べてください。"

注意: 方法2でインストールした場合はuv run mixseek exec ...としてください。

実行内容:

汎用調査チームがWeb検索を実行
検索結果をまとめて回答を生成
評価システムが回答を評価（Coverage, Relevance, Novelty, Clarity）
結果をコンソールに出力

実行時間: 約1分

設定ファイルの説明

`search_news.toml` - シンプルなニュース検索

[orchestrator]
timeout_per_team_seconds = 180
min_rounds = 1
max_rounds = 2

[[orchestrator.teams]]
config = "configs/agents/team_general_researcher.toml"

単一チーム: 汎用調査チームのみを使用
高速実行: 1〜2ラウンドで完了
デフォルト評価: システムデフォルトの評価設定を使用

参考: 詳細はオーケストレーターガイドを参照

`team_general_researcher.toml` - 汎用調査チーム

[team]
team_id = "general-researcher-team"
team_name = "General Research Team"

[team.leader]
model = "google-gla:gemini-2.5-flash"
temperature = 0.7

[[team.members]]
name = "general-searcher"
type = "web_search"
model = "google-gla:gemini-2.5-flash"

Leader Agent: チーム全体の調整とまとめを担当
Member Agent: Web検索を実行してニュース情報を収集
モデル: Gemini 2.5 Flash を使用（高速・低コスト）

参考: 詳細はチームガイドを参照

次のステップ

さらに学ぶ

基本的なニュース検索ができたら、次のステップに進みましょう：

はじめに（発展編） - 多視点検索、カスタマイズ、Web UIの使い方
オーケストレーターガイド - 複数チームの並行実行と評価
チームガイド - チーム設定の詳細とカスタマイズ方法

トラブルシューティング

エラー: “No API key found”

原因: Google APIキーが設定されていない

解決策:

export GOOGLE_API_KEY=your-api-key
# または
export GOOGLE_GENAI_USE_VERTEXAI=true
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/credentials.json

エラー: “Workspace not found”

原因: ワークスペースが初期化されていない

解決策:

mixseek init --workspace $HOME/mixseek-workspace

エラー: “Config file not found”

原因: 設定ファイルのパスが正しくない

解決策:

# ワークスペース基準の相対パスを使用
mixseek exec \
  --workspace $HOME/mixseek-workspace \
  --config configs/search_news.toml \
  "query"

# または絶対パスを使用
mixseek exec \
  --workspace $HOME/mixseek-workspace \
  --config $HOME/mixseek-workspace/configs/search_news.toml \
  "query"

注意: 方法2でインストールした場合はuv runプレフィックスを追加してください。

はじめに - 5分でスタート

前提条件

uvのインストール

mixseek-coreのインストール

ステップ1: ワークスペースの初期化

ステップ2: API認証の設定

オプションA: Gemini Developer API（個人・プロトタイピング向け）

オプションB: Vertex AI（エンタープライズ向け）

ステップ3: 最初のニュース検索を実行

設定ファイルの説明

`search_news.toml` - シンプルなニュース検索

`team_general_researcher.toml` - 汎用調査チーム

次のステップ

さらに学ぶ

トラブルシューティング

エラー: “No API key found”

エラー: “Workspace not found”

エラー: “Config file not found”

関連ドキュメント

次のステップ

詳細ガイド

リファレンス

はじめに - 5分でスタート

前提条件

uvのインストール

mixseek-coreのインストール

ステップ1: ワークスペースの初期化

ステップ2: API認証の設定

オプションA: Gemini Developer API（個人・プロトタイピング向け）

オプションB: Vertex AI（エンタープライズ向け）

ステップ3: 最初のニュース検索を実行

設定ファイルの説明

search_news.toml - シンプルなニュース検索

team_general_researcher.toml - 汎用調査チーム

次のステップ

さらに学ぶ

トラブルシューティング

エラー: “No API key found”

エラー: “Workspace not found”

エラー: “Config file not found”

関連ドキュメント

次のステップ

詳細ガイド

リファレンス

`search_news.toml` - シンプルなニュース検索

`team_general_researcher.toml` - 汎用調査チーム