⚙️ 初期設定

モデルの選択・APIキーの登録・追加ツールの有効化などHermesを使い始めるための設定を説明します。

🤖 モデルの選択

Hermesはどのモデルプロバイダーとも連携できます。hermes model コマンドで対話的に選択するのが最も簡単です。

hermes model

主なプロバイダー

プロバイダー	特徴	APIキー取得先
Nous Portal	1つのサブスクで300+モデル・画像生成・Web検索が使える。最もシンプル	portal.nousresearch.com
OpenRouter	200+モデルをAPI一本で。従量課金	openrouter.ai
OpenAI	GPT-4o・o3等	platform.openai.com
ローカルLLM	ollama / omlx等でモデルをローカル実行。APIキー不要	—

💡

ローカルLLMを使う場合（推奨）
omlx（Apple Silicon）またはollama（汎用）をインストールし、hermes model でプロバイダーとして選択。モデルはQwen3.6-35B-A3B等のツール呼び出し性能が高いものを推奨。

🔑 APIキー・環境変数の設定

APIキーは ~/.hermes/.env に記述します。このファイルはHermes起動時に自動で読み込まれます。

# ~/.hermes/.env の例
OPENROUTER_API_KEY=sk-or-v1-xxx...
FAL_KEY=fal_xxx...              # 画像生成（fal.ai）
TENOR_API_KEY=xxx...            # GIF検索
LINEAR_API_KEY=lin_api_xxx...   # Linear
NOTION_API_KEY=secret_xxx...    # Notion

⚠️

.env ファイルにはシークレットキーが含まれます。gitリポジトリにはコミットしないでください。

🛠️ ツールの有効・無効化

Hermesのツール（ファイル操作・Web検索・Pythonコード実行など）はプロファイルごとに管理されます。

hermes tools          # ツール一覧と有効/無効状態を表示
hermes tools enable web
hermes tools disable browser

ℹ️

ツールを絞り込むほどHermesの処理が速くなります。用途ごとにプロファイルを分けるのがベストプラクティスです。

🔌 MCPサーバーの追加

MCP（Model Context Protocol）サーバーを追加することで、ComfyUI・WordPress・Google Workspace等の外部ツールをHermesから操作できます。

設定ファイルの場所

~/.hermes/config.yaml

WordPress MCP の例

mcp_servers:
  wordpress:
    type: stdio
    command: uv
    args: ["run", "--with", "mcp-wordpress", "mcp-wordpress"]
    env:
      WORDPRESS_SITE_URL: "https://yourblog.com"
      WORDPRESS_USERNAME: "admin"
      WORDPRESS_APP_PASSWORD: "xxxx xxxx xxxx"

主なMCPサーバー

用途	パッケージ	必要なもの
WordPress	mcp-wordpress	サイトURL・アプリパスワード
ComfyUI画像生成	comfyui-mcp（またはカスタム）	ComfyUIサーバー起動中
SearXNG Web検索	searxng-mcp	SearXNGサーバー起動中
Google Workspace	google-workspace-mcp	Google Cloud OAuth設定

🍎 macOS専用スキルの権限設定

Apple Notes / Reminders / Find My などのmacOS統合スキルを使う場合、追加のCLIツールインストールとmacOS権限付与が必要です。

CLI ツールのインストール
HermesのSandbox環境はbrewをブロックするため、システムのbrew（絶対パス）を使います。
/opt/homebrew/bin/brew install steipete/tap/memo # Apple Notes /opt/homebrew/bin/brew install steipete/tap/remindctl # Apple Reminders
macOS権限の付与
各ツールの初回実行時にmacOSが権限ダイアログを表示します。「許可」を選択してください。
もし表示されない場合：システム設定 → プライバシーとセキュリティ から手動で有効化できます。
動作確認
Hermesに「Apple Notesのリストを見せて」と話しかけて動作確認します。

← インストール次：起動・操作 →