RemoraFish

Русский · 简体中文

Agent-first-Framework, das Ihre autorisierten ChatGPT-, DeepSeek-, Kimi-, Grok- und externen Provider-Websitzungen in OpenAI-kompatible APIs, Anthropic Messages und MCP-Tools verwandelt. Es enthält eine Headless-Laufzeit, ein Provider-SDK, eine Account-Control-Plane, integrierte Referenz-Provider und eine Referenz-Web-UI.

[!IMPORTANT] Sie sind allein verantwortlich für Ihre Konten und für jede mit RemoraFish durchgeführte Aktion. Verwenden Sie es nur mit Konten und Browserprofilen, die Sie besitzen oder für die Sie ausdrücklich autorisiert sind. Sie sind verantwortlich für die Sicherheit der Anmeldedaten, die Einhaltung der Provider-Bedingungen und geltenden Gesetze sowie für Konsequenzen wie Kontoeinschränkungen, Sperrung oder Verlust. Die Projektautoren betreiben Ihre Konten nicht und garantieren deren Verfügbarkeit nicht.

RemoraFish v0.2 ist eine Framework-Vorschau. Es verwendet Websitzungen anstelle offizieller Entwickler-API-Schlüssel. Provider können ihre privaten Protokolle ändern oder Konten einschränken; verwenden Sie kein Konto, dessen Verlust Sie sich nicht leisten können. Das öffentliche Repository enthält keine Benutzeranmeldedaten. Browsersitzungen und Token-Caches sind lokale Laufzeitdaten, die standardmäßig außerhalb des Projektverzeichnisses gespeichert werden.

Drei Möglichkeiten, RemoraFish zu nutzen

Die gebündelte UI ist bewusst eine Referenzanwendung, nicht die Framework-Grenze. Agents, API-Clients, benutzerdefinierte Frontends und Produkt-Forks verwenden alle dieselbe Headless-Laufzeit.

Related MCP server: codex-web-bridge

Schnellstart

1. Installation

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

2. Einen Coding-Agent verbinden

Coding-Agents sollten mit AGENTS.md beginnen. Wenn ein Agent den RemoraFish-Projektkontext dauerhaft über Sitzungen hinweg benötigt, installieren und konfigurieren Sie choirboy-prompt als optionalen Anweisungs-Transport. Ersetzen Sie dessen gebündelte Demonstrations-Lore durch den RemoraFish-Projektleitfaden; verwenden Sie die Demo-Biografie nicht unverändert.

3. Die Agent-Control-Plane starten

Der empfohlene Arbeitsablauf besteht darin, einen lokalen Coding-Agent die Kontoeinrichtung über den separaten Admin-MCP orchestrieren zu lassen. RemoraFish selbst scannt den Browser des Benutzers, hält rohe Anmeldedaten aus dem Agent-Kontext heraus, gibt maskierte Kandidaten zurück und importiert nur ausdrücklich bestätigte Auswahlen:

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

Direkte CLI und Referenz-UI

Die CLI und die Referenz-UI bleiben für den direkten Betrieb verfügbar:

# 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

Der Server lauscht standardmäßig auf http://127.0.0.1:8787. Öffnen Sie Einstellungen → Konten, um beliebig viele Provider-Konten mit einem Proxy pro Konto hinzuzufügen. RemoraFish kann einen isolierten lokalen Browser öffnen, ein gespeichertes Login/Passwort übermitteln, auf MFA oder Captcha warten, das resultierende Laufzeit-Token erfassen und das Konto ohne Neustart zum aktiven Routing-Pool hinzufügen.

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

Agents können lokale Dateien über web_chat anhängen. Der Aufruf muss attachments: [{"path":"./report.pdf"}] und explizites confirm_file_access: true enthalten; RemoraFish validiert den Pfad und die Grenzwerte, lädt die Bytes über den nativen ChatGPT-, DeepSeek-, Kimi- oder Grok-Webfluss des ausgewählten Providers hoch und hält lokale Pfade aus den Provider-Adaptern heraus. HTTP-Clients können Inline-Base64-Bild-/Dateiteile verwenden. Siehe HTTP-APIs und MCP.

Was verfügbar ist

Der Browser-Import unterstützt Chrome, Chromium, Edge, Brave, Vivaldi, Opera, Firefox und LibreWolf auf Linux, macOS und Windows. Rohe Geheimnisse werden im Terminal und in der JSON-Ausgabe maskiert; gespeicherte Anmeldedaten gehen an ~/.remorafish/accounts.json mit Modus 0600. Login/Passwort und authentifizierte Proxy-URLs werden getrennt in der verschlüsselten Datei ~/.remorafish/account_vault.json aufbewahrt; ihr lokaler Schlüssel und persistente Login-Profile verwenden ebenfalls Nur-Eigentümer-Berechtigungen.

ChatGPT wird als chatgpt/auto bereitgestellt; chatgpt/auto-search aktiviert die Websuche-Funktion. Verbinden Sie es über Einstellungen → Konten → ChatGPT mit einem Zugriffstoken, einem Import einer bestehenden Browsersitzung oder interaktiver Browser-Anmeldung. Das ChatGPT-Webprotokoll enthält eine sich ändernde Anti-Bot-Schicht, daher ist nach Änderungen am Upstream-Frontend weiterhin ein Live-Konto-Smoke-Test erforderlich.

Dokumentation

• So funktioniert das System

• Provider-Framework und formaler Vertrag

• Agent-first-Account-Control-Plane

• Referenz-UI-Grenze

• Browser-Anmeldedaten-Extraktion

• Multi-Konto-Verwaltung und Routing

• OpenAI-, Anthropic- und MCP-Schnittstellen

• Testen realer Web-Abonnements

• Ursprünglicher Designvertrag und Protokollforschung

Entwicklung

uv run pytest -q
uv run remorafish providers check

Die offizielle Agentation-Symbolleiste ist als React-Island gebündelt, das nur auf localhost verfügbar ist, damit die Haupt-Web-UI framework-frei bleiben kann. Bauen Sie sie nach Abhängigkeitsänderungen neu:

npm install
npm run build:agentation

Agent Sync verwendet http://localhost:4747. Registrieren Sie seinen MCP-Server mit Codex:

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

Starten Sie Codex nach Änderungen an der MCP-Konfiguration neu. Der RemoraFish-Quellcode ist MIT-lizenziert. Die gebündelte Agentation-Komponente bleibt unter PolyForm Shield 1.0.0; ihr erforderlicher Hinweis wird als remorafish/webui/agentation.LICENSE.txt ausgeliefert. Siehe Drittanbieter-Hinweise für Protokollimplementierungs-Zuschreibungen und alle Lizenzgrenzen.