RemoraFish

ロシア語 · 簡体字中国語

認可済みのChatGPT、DeepSeek、Kimi、Grok、および外部プロバイダーのWebセッションを、OpenAI互換API、Anthropic Messages、MCPツールに変換するためのエージェントファーストのフレームワークです。ヘッドレスランタイム、プロバイダーSDK、アカウントコントロールプレーン、組み込みのリファレンスプロバイダー、リファレンスWeb UIを同梱しています。

[!IMPORTANT] あなたは、あなたのアカウントと、RemoraFishを使って実行されるすべての操作について単独で責任を負います。 必ず、あなた自身が所有する、または明示的に操作を許可されているアカウントとプロファイルでのみ使用してください。認証情報の管理、プロバイダー規約および適用される法律の遵守、アカウントの制限・停止・喪失などの結果についても、あなたに責任があります。プロジェクトの作者は、あなたのアカウントを運用したり、その利用可能性を保証したりするものではありません。

RemoraFish v0.2 はフレームワークのプレビュー版です。公式の開発者APIキーではなく、Webセッションを使用します。プロバイダーは非公開プロトコルを変更したり、アカウントを制限する場合があります。失っても構わないアカウントを使用しないでください。公開リポジトリにはユーザーの認証情報は含まれません。ブラウザセッションとトークンキャッシュは、デフォルトではプロジェクトツリー外に保存されるローカルランタイムデータです。

RemoraFishの3つの使い方

同梱のUIは、フレームワークの境界ではなく、あくまでリファレンスアプリケーションです。エージェント、APIクライアント、カスタムフロントエンド、プロダクトフォークはすべて、同じヘッドレスランタイムを使用します。

Related MCP server: codex-web-bridge

クイックスタート

1. インストール

git clone https://github.com/howdeploy/remorafish.git
cd remorafish
uv sync --extra dev

2. コーディングエージェントに接続する

コーディングエージェントは、まず AGENTS.md から始めてください。エージェントがRemoraFishプロジェクトのコンテキストをセッションをまたいで永続的に受け取る必要がある場合は、オプションの指示トランスポートとして choirboy-prompt をインストールして設定してください。同梱のデモ用ロアをRemoraFishプロジェクトガイドに置き換えてください。デモのバイオグラフィーをそのまま使わないでください。

3. エージェントのコントロールプレーンを起動する

推奨されるワークフローは、ローカルのコーディングエージェントに、個別のAdmin MCPを介してアカウントのセットアプ量をオーケストレーションさせることです。RemoraFish自身は、ユーザーのブラウザをスキャンし、生の認証情報をエージェントのコンテキストに入れず、マスクされた候補を返し、明示的に確認されたものだけをインポートします。

uv run remorafish admin-mcp \
  --allow-browser-scan \
  --allow-account-mutations

CLIとリファレンスUIを直接使う

CLIとリファレンスUIは、直接操作するための手段として引き続き利用できます。

# Browsers may stay open. Scan live snapshots, validate, and save valid accounts.
uv run remorafish accounts scan --browser all --check --save --yes

# Or choose several browsers and get agent-friendly JSON.
uv run remorafish accounts scan -b brave -b firefox --check --json

uv run remorafish serve

サーバーは、デフォルトで http://127.0.0.1:8787 で待ち受けます。Settings → Accounts を開き、アカウントごとのプロキシを指定して任意の数のプロバイダーアカウントを追加できます。RemoraFishは、隔離されたローカルブラウザを開いて保存済みのログインID/パスワードを送信し、MFAまたはCAPTCHAを待って、結果のランタイムトークンを取得し、再起動なしでアカウントをライブルーティングプールに追加できます。

curl http://127.0.0.1:8787/v1/responses \
  -H 'Content-Type: application/json' \
  -d '{"model":"deepseek/chat","input":"Hello"}'

# MCP over stdio
uv run remorafish mcp

エージェントは、web_chat を介してローカルファイルを添付できます。呼び出しには、attachments: [{"path":"./report.pdf"}] と 明示的な confirm_file_access: true を含める必要があります。RemoraFishはパスと制限を検証し、選択されたプロバイダーのネイティブなChatGPT、DeepSeek、Kimi、またはGrokのWebフローでバイト列をアップロードし、ローカルパスをプロバイダーアダプターに渡しません。HTTPクライアントは、インラインのbase64画像・ファイルパートを使用できます。HTTP APIとMCP を参照してください。

利用可能な機能

ブラウザのインポートは、Linux、macOS、Windows上のChrome、Chromium、Edge、Brave、Vivaldi、Opera、Firefox、LibreWolfをサポートしています。生のシークレットは、ターミナルとJSON出力でマスクされます。保存された認証情報は、~/.remorafish/accounts.json にモード 0600 で保存されます。ログインID/パスワードと認証付きプロキシURLは、暗号化された ~/.remorafish/account_vault.json に別に保管されます。ローカルキーと永続的なログインプロファイルにも、所有者のみの権限が適用されます。

ChatGPTは chatgpt/auto として公開され、chatgpt/auto-search はWeb検索機能を有効にします。Settings → Accounts → ChatGPT から、アクセストークン、既存のブラウザセッションのインポート、または対話的なブラウザサインインで接続できます。ChatGPTのWebプロトコルは変化するアンチボット層を含むため、上流フロントエンドが変更された後も、実アカウントでのスモークテストが必要です。

ドキュメント

• システムの仕組み

• プロバイダーフレームワークと正式な契約

• エージェント優先のアカウント・コントロールプレーン

• リファレンスUIの境界

• ブラウザの認証情報の抽出

• 複数アカウントの管理とルーティング

• OpenAI、Anthropic、MCPインターフェース

• 実際のWebサブスクリプションを使っテスト

• 当初の設計契約 と プロトコル調査

開発

uv run pytest -q
uv run remorafish providers check

公式のアジエンテーションツールバーは、メインのWeb UIをフレームワークなしで維持できるように、localhost限定のReact islandとして同梱されています。依存関係の変更後には再ビルドしてください。

npm install
npm run build:agentation

Agent Syncは http://localhost:4747 を使用します。そのMCPサーバーをCodexに登録します。

codex mcp add agentation -- npx -y agentation-mcp server

MCP設定を変更したら、Codexを再起動してください。RemoraFishのソースコードはMITライセンスです。同梱のAgテーションコンポーネントは引き続きPolyForm Shield 1.0.0の下にあります。その必要大きな通知は、第三者の通知を参照してください。remorafish/webui/agentation.LICENSE.txt に同梱されています。プロトコル実装の帰属とすべてのライセンス境界については、サードパーティ通知 を参照してください。