ドキュメント · ガイド

Empryo を任意のモデルで

Empryo の設定は ~/.empryo/config.json にあります（プロジェクトの .empryo/config.json が上書きします）。プロバイダーは providers 配列で、各項目は OpenAI 互換のエンドポイントです。Empryo はそこからモデルを一覧し、/chat/completions を呼びます。magpie はそこに自分のプロバイダーを加え、セッションの開始モデルを magpie のモデルにします。これで Empryo が DeepSeek、GLM、Kimi、Qwen、GPT、ChatGPT サブスクリプションなど magpie の任意のモデルで動きます。

Empryo の設定

  1. magpie にプロバイダーを追加プロバイダー ページで API キーを追加するか、サブスクリプションにサインインします。
  2. エージェント ページで Empryo のモデルを選ぶEmpryo の行には今の Empryo のモデルと via magpie のモデルがあります。後者を選びます。
  3. empryo を再起動Empryo は起動時に設定を読むので、開いているセッションは開き直します。
ターミナル
magpie empryo deepseek/deepseek-v4-pro

Windows では WSL ディストリビューション内の Empryo も見つかり、そのディストリビューションから届くゲートウェイアドレスで同じように設定されます。

書き込まれる内容

ターミナル
{
  "providers": [
    …your own providers, left as they are…,
    {"id": "magpie", "name": "Magpie",
     "baseURL": "http://127.0.0.1:3425/v1",
     "modelsAPI": "http://127.0.0.1:3425/v1/models"}
  ],
  "defaultModel": "magpie/deepseek/deepseek-v4-pro"
}

defaultModel は <プロバイダー id>/<モデル id> で、最初の / で分けられます。magpie/deepseek/deepseek-v4-pro は magpie プロバイダーの deepseek/deepseek-v4-pro です。自分のプロバイダーや他の設定はそのままです。

magpie は接続を確かめます。config.json の magpie プロバイダーが消えたり、その baseURL が今のゲートウェイアドレスでなくなったりすると、Empryo の行がそう伝えます。

envVar がない理由

Empryo のプロバイダーは envVar でキーを読む環境変数を指定でき、ないときはあなたのキーを送りません。magpie のプロバイダーには envVar がないので、環境にキーを置く必要はありません。envVar がないとき、Empryo は baseURL が応答する（2xx、401、403）プロバイダーだけを一覧し、ゲートウェイの GET /v1 は応答します。

反映されるタイミング

Empryo は起動時にだけ設定を読みます。empryo が動いているとき、magpie は開いている empryo セッションの再起動を促します。

元に戻す

既定に戻すと、defaultModel を接続前の値に戻し、magpie プロバイダーを削除します。config.json を magpie が作っていて空になれば、ファイルごと消します。自分の Empryo のモデルを選び直しても戻せます。

ターミナル
magpie empryo default

よくある質問

Empryo で DeepSeek、GLM、ChatGPT サブスクリプションを使うには？

magpie のエージェントページで Empryo に via magpie のモデルを選びます。magpie が ~/.empryo/config.json に id が magpie のプロバイダーを加え、defaultModel を magpie/プロバイダー/モデル にします。empryo を再起動すると使えます。

API キーの環境変数は必要ですか？

いいえ。magpie のプロバイダーには envVar がないので Empryo はあなたのキーを送らず、magpie ゲートウェイが magpie に追加したプロバイダーへ転送します。

プロジェクトの .empryo/config.json は影響しますか？

はい。プロジェクトの .empryo/config.json は ~/.empryo/config.json を上書きし、独自の defaultModel があればそのプロジェクトではそちらが使われます。

元に戻すと前のモデルは残っていますか？

はい。magpie は元の defaultModel を控えておき、戻すときに元に戻します。自分のプロバイダーは一度も変えていません。

同じモデルを他のエージェントでも：Lody を任意のモデルで、AtomCode を任意のモデルで、Crush を任意のモデルで、miniQ を任意のモデルで。エラーが出るときは よくあるエラーの直し方、または Discord で質問してください。