RemoraFish

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

Фреймворк, ориентированный на агентов, для превращения ваших авторизованных веб-сессий ChatGPT, DeepSeek, Kimi, Grok и внешних провайдеров в API, совместимые с OpenAI, Anthropic Messages и инструменты MCP. В комплекте: headless-рантайм, SDK провайдеров, плоскость управления аккаунтами, встроенные эталонные провайдеры и эталонный веб-интерфейс.

[!IMPORTANT] Вы несёте полную ответственность за свои аккаунты и за каждое действие, совершённое с помощью RemoraFish. Используйте его только с аккаунтами и профилями браузера, которыми вы владеете или на работу с которыми у вас есть явное разрешение. Вы отвечаете за безопасность учётных данных, соблюдение условий провайдеров и применимого законодательства, а также за последствия, включая ограничение аккаунта, его приостановку или потерю. Авторы проекта не управляют вашими аккаунтами и не гарантируют их доступность.

RemoraFish v0.2 — это предварительная версия фреймворка. Она использует веб-сессии, а не официальные ключи разработчика API. Провайдеры могут менять свои закрытые протоколы или ограничивать аккаунты; не используйте аккаунт, который вы не можете позволить себе потерять. Публичный репозиторий не содержит пользовательских учётных данных. Сессии браузера и кэши токенов — это локальные данные рантайма, по умолчанию хранящиеся вне дерева проекта.

Три способа использования RemoraFish

Встроенный UI намеренно является эталонным приложением, а не границей фреймворка. Агенты, API-клиенты, кастомные фронтенды и продуктовые форки используют один и тот же headless-рантайм.

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. Откройте Настройки → Аккаунты, чтобы добавить любое количество аккаунтов провайдеров с прокси для каждого аккаунта. RemoraFish может открыть изолированный локальный браузер, отправить сохранённый логин/пароль, дождаться MFA или капчи, захватить полученный рантайм-токен и добавить аккаунт в живой пул маршрутизации без перезапуска.

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 и не допускает локальные пути в адаптеры провайдеров. HTTP-клиенты могут использовать встроенные base64-части изображений/файлов. См. HTTP API и MCP.

Что доступно

Импорт из браузера поддерживает Chrome, Chromium, Edge, Brave, Vivaldi, Opera, Firefox и LibreWolf на Linux, macOS и Windows. Сырые секреты маскируются в терминале и JSON-выводе; сохранённые учётные данные попадают в ~/.remorafish/accounts.json с правами 0600. Логин/пароль и URL аутентифицированных прокси хранятся отдельно в зашифрованном ~/.remorafish/account_vault.json; его локальный ключ и постоянные профили входа также используют права только для владельца.

ChatGPT доступен как chatgpt/auto; chatgpt/auto-search включает функцию веб-поиска. Подключите его через Настройки → Аккаунты → ChatGPT с access-токеном, импортом существующей сессии браузера или интерактивным входом в браузере. Веб-протокол ChatGPT включает меняющийся анти-бот слой, поэтому после изменений фронтенда у провайдера всё равно требуется живой smoke-тест аккаунта.

Документация

• Как работает система

• Фреймворк провайдеров и формальный контракт

• Плоскость управления аккаунтами, ориентированная на агентов

• Границы эталонного UI

• Извлечение учётных данных из браузера

• Управление несколькими аккаунтами и маршрутизация

• Интерфейсы OpenAI, Anthropic и MCP

• Тестирование реальных веб-подписок

• Оригинальный дизайн-контракт и исследование протоколов

Разработка

uv run pytest -q
uv run remorafish providers check

Официальная панель Agentation встроена как React-остров, доступный только через localhost, чтобы основной веб-UI оставался свободным от фреймворков. Пересоберите её после изменений зависимостей:

npm install
npm run build:agentation

Agent Sync использует http://localhost:4747. Зарегистрируйте его MCP-сервер в Codex:

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

Перезапустите Codex после изменения конфигурации MCP. Исходный код RemoraFish распространяется под лицензией MIT. Встроенный компонент Agentation остаётся под PolyForm Shield 1.0.0; его обязательное уведомление поставляется как remorafish/webui/agentation.LICENSE.txt. См. уведомления о сторонних компонентах для атрибуций реализации протоколов и всех границ лицензий.