Bench Studio

Хватит арендовать обёртку. Владейте творческим слоем.

Локальная креативная студия для изображений, видео, веб-сайтов, дизайнерских PDF и рабочих процессов с AI-агентами.

Быстрый старт · Советы · Как это работает в деталях · Что изменилось и почему · Безопасность

Bench Studio объединяет 73 тщательно отобранных маршрута для изображений и видео от 5 провайдеров, уточнение промптов, контроллеры с учётом возможностей, локальное хранение файлов и прозрачный учёт затрат в едином интерфейсе. Та же система доступна Claude, Codex, Cursor и другим совместимым клиентам через MCP.

Ваши ключи остаются на серверной стороне вашей машины. Ваши промпты можно редактировать до того, как вы потратите средства. Ваши результаты зеркалируются локально. Ваши затраты фиксируются в реальных единицах, а не исчезают в таинственных кредитах.

[!NOTE] Это очищенная публичная версия. Она поставляется без истории генерации, загрузок, частной базы данных, личных путей, учётных данных или локальных артефактов сборки. Ваш архив начинается пустым.

📖 Guia de uso

Полное руководство (лендинг + пошаговая инструкция): https://inematds.github.io/bench-studio-en/guia/

Related MCP server: omnicinema-mcp

Зачем это нужно

Большинство креативных AI-продуктов объединяют пять полезных компонентов — доступ к моделям, полировку промптов, маршрутизацию, хранение и биллинг — а затем прячут стыки за ежемесячным планом. Bench сохраняет удобство, делая каждый стык проверяемым.

Bench не владеет базовыми моделями. Он даёт вам владение переносимым слоем, который соединяет ваши идеи, инструменты, провайдеров, файлы и затраты.

Запуск за три минуты

Что вам нужно

Обязательно

• Node.js 22.5+; рекомендуется Node 24, так как Bench использует node:sqlite.

• npm.

Это весь список. Каждый провайдер опционален и деградирует самостоятельно: отсутствующий ключ делает соответствующие модели недоступными с указанием причины и способа её исправления — студия всё равно запускается. Возьмите хотя бы один из них, чтобы что-то генерировать:

Опционально, но стоит того

• Ключ Google AI Studio или OpenRouter для уточнения промптов. Без уточнителя ваш промпт отправляется как есть — что Agnes отклоняет, так как требует английский.

• Google Chrome для печати PDF и визуальной предварительной проверки.

• Авторизованный Codex или Claude Code для создания веб-сайтов и документов с помощью агентов.

1. Клонируйте и установите

git clone https://github.com/inematds/bench-studio-en.git
cd bench-studio-en
npm install

2. Добавьте серверные учётные данные

cp .env.example .env

Заполните то, что у вас есть. .env.example документирует все 19 переменных — что каждая из них открывает, как выставляется счёт и где создать ключ. Ключи остаются на серверной стороне и никогда не отправляются в браузер; .env игнорируется git и записывается с правами только для владельца.

Порядок чтения, сначала самые важные:

exported in your shell  >  .env in the project  >  ~/.env

Или полностью пропустите файл: запустите студию и используйте кнопку Config в правом верхнем углу. Она показывает все настройки — присутствующие или отсутствующие, откуда взялось значение и последние 4 символа — позволяет протестировать каждого провайдера и записывает .env за вас. В целях безопасности она принимает записи только с машины, на которой запущена студия.

3. Запустите студию

npm run dev

Откройте http://localhost:5200.

Если какой-либо порт занят:

PORT=8790 BENCH_API_PORT=8790 BENCH_WEB_PORT=5201 npm run dev

Доступ с другой машины

Оба порта привязаны к loopback, поэтому свежая установка отвечает только вам. Открытие доступа означает три вещи — интерфейс, слушающий на всех интерфейсах, правило брандмауэра и необходимость не забыть отменить оба. Одна команда делает всё это:

./scripts/remote.sh open      # publish the interface on this machine's IP
./scripts/remote.sh status    # open or closed, and with what protection
./scripts/remote.sh close     # back to local access only

open выводит адрес для раздачи, затем сообщает перезапустить с помощью npm run dev. close отменяет ровно то, что сделал open — читая файл состояния, записанный при открытии, а не угадывая — и оставляет правило SSH нетронутым, потому что его удаление — это способ заблокировать себя от собственного сервера.

Два флага, которые стоит знать:

./scripts/remote.sh open --ip 203.0.113.7   # only that address, not the internet
./scripts/remote.sh open --firewall         # also enable ufw (SSH allowed first)

open предлагает установить пароль перед открытием доступа. Согласитесь — и он передаст управление npm run set-password; нажмите Enter — или ответьте n — и студия откроется без пароля, что является задокументированным поведением по умолчанию. Предложение существует из-за асимметрии ниже: это последний момент, когда установка пароля находится в одном нажатии клавиши.

Пароль нельзя установить или изменить с другой машины — даже после входа в систему. POST /api/config/password отвечает 403 на всё, что пришло не с loopback, независимо от сессии, и экран Config сообщает об этом вместо того, чтобы показывать неактивное поле. Это правило предотвращает ситуацию, когда кто-то, нашедший открытый порт, может установить свой пароль и заблокировать вам доступ к собственной студии. Итак:

npm run set-password    # on the machine running the studio, over SSH or at the keyboard

Что open намеренно не делает: публикует API. Порт 8787 остаётся на loopback (BENCH_API_HOST), поэтому эндпоинт, который записывает файлы и тратит деньги, доступен только через интерфейс, на самой машине.

Это тестовая конфигурация, а не развёртывание. Трафик идёт по обычному HTTP и читается при передаче. Для чего-либо, что остаётся работать, прочитайте следующий раздел.

Безопасное оставление включённым

В порядке, который действительно вас защищает:

1. Установите пароль при установке. На машине, которая будет доступна, сделайте это частью настройки — npm install, затем npm run set-password, затем ./scripts/remote.sh open. Выполнение в таком порядке гарантирует, что студия никогда не будет открыта без пароля, и вам никогда не понадобится экран пароля, который вы всё равно не можете использовать из сети.

2. Оставьте API на loopback. По умолчанию. BENCH_API_HOST=0.0.0.0 — это отказ от настройки, для которого должна быть причина.

3. Ограничьте, кто может получить доступ. ./scripts/remote.sh open --ip <ваш-ip> лучше, чем открытый порт. Адрес Tailscale лучше обоих и вообще не требует порта.

4. Включите брандмауэр. ./scripts/remote.sh open --firewall сначала разрешает SSH, затем включает ufw. Также проверьте панель брандмауэра вашего VPS-провайдера — она находится перед ufw и не подчиняется никому на машине.

5. Завершите HTTPS спереди. Направьте домен на машину и поставьте nginx или Caddy спереди с сертификатом Let's Encrypt, проксируя /api, /media, /previews, /inputs и /projects на 127.0.0.1:8787 и обслуживая dist/ из npm run build как сайт. Затем полностью закройте 5200. Если вы это сделаете, заставьте прокси отправлять X-Forwarded-For: от этого зависит правило только для машины ниже.

6. Запускайте от отдельного пользователя, не root, под systemd-юнитом, с .env на 600 — именно так студия его записывает.

7. Закрывайте, когда тест закончен. ./scripts/remote.sh close. Забытая уязвимость — это та, которая стоит вам кредитов провайдера.

Советы, которые экономят ваше время и деньги

Начните с бесплатных маршрутов. Agnes (4 модели) и inemaimg (2, на вашем собственном GPU) ничего не стоят. В каталоге моделей переключатель No cost включает именно эту группу. Используйте их, чтобы найти подходящий промпт, затем потратьте средства на модель, которая лучше всего его отображает.

Отфильтруйте каталог один раз. 73 модели — это много для прокрутки. Отфильтруйте по провайдеру, затем используйте "Disable those N", чтобы скрыть то, что вы не будете использовать. Курирование — это предпочтение, а не блокировка: оно скрывает модели из выбора, но Redo старого результата всё равно работает. Удаление data/catalog-prefs.json восстанавливает заводское состояние.

Уточняйте перед тратой. Уточнённый промпт можно редактировать перед отправкой. Прочитайте его. Это самое дешёвое место, чтобы поймать недопонимание — после отправки исправление будет стоить ещё одного запуска.

Держите два уточнителя настроенными. Цепочка: Gemini → OpenRouter → локальный Codex. С одним уточнителем исчерпанная квота выводит из строя всю студию: промпт проходит как есть, и Agnes отклоняет неанглийский с ошибкой, которая выглядит как проблема Agnes, но это не так.

Используйте Redo вместо повторного ввода. Каждый результат содержит модель, элементы управления, уточнённый промпт, исходную идею и вложения. Redo восстанавливает всё это, так что вы можете изменить одну вещь, не платя за переписывание.

Одна и та же модель может существовать на двух маршрутах. Veo, Nano Banana, gpt-image и gemini-image доступны через нескольких провайдеров — с разными счетами (доллары на fal, кредиты плана на Kling). Провайдер указан рядом с именем в выборе; это реальный выбор, а не дубликат.

Kling никогда не повторяет попытки автоматически, намеренно. Каждый job Kling оплачивается, включая неудачные. Ничто не отправляется повторно за вашей спиной.

Следите за диском, а не за CPU. Каждый файл зеркалируется локально, потому что URL-адреса провайдеров истекают — 24 часа у Kling, временные у Agnes. Примерно 1,3 МБ на изображение и 0,7–5 МБ на видео. Студия потребляет 274 МБ ОЗУ в режиме ожидания.

Создаёте веб-сайт? Предпочтите агента. Codex и Claude Code сами записывают файлы и исправляют свои ошибки. Движки моделей (локальный Qwen, OpenRouter) возвращают только текст, поэтому им не нужна песочница и они ничего не стоят — но требуют больше контроля.

Направьте сборщик на эталон, которым вы владеете. Укажите свой сайт или PDF в Config, и сборщик откалибрует свою отделку по нему — токены, шрифты, палитру, радиусы. Он никогда не копирует бренд, копирайтинг, структуру или файлы.

Что вы можете создать

Вы — движок перевода. Переведите с en-US на ru-RU. Верните JSON-объект с единственным ключом "translation", содержащим переведенный текст.

Переводите только прозу. Сохраните дословно в исходном написании, включая случаи, когда они встречаются в бегущем тексте без обратных кавычек:

• Названия продуктов, проектов, организаций и репозиториев (Claude Desktop, Playwright, Node.js, owner/my-mcp-server).

• Имена пакетов, модулей, инструментов, функций и аргументов ("slug", "symbol", get-quotes, @modelcontextprotocol/sdk).

• Переменные окружения, флаги CLI, пути к файлам, ключи JSON и схемы URI (GITHUB_TOKEN, --verbose, ~/Library/Application Support, mcp://).

• URL-адреса, цели ссылок, фрагменты якорей и источники изображений.

• Текст внутри строчного кода (...) и токены-заполнители (например, GXP1, GXP2).

Сохраните структуру документа в точности:

• Каждый элемент во входных данных должен присутствовать в выходных данных, то же количество раз и в том же порядке. Никогда не удаляйте изображения, значки или ссылки, включая те, что написаны в виде сырого HTML.

• В сыром HTML переводите только текстовое содержимое, никогда не трогайте теги или их атрибуты.

• Сохраняйте заголовки, маркированные списки, нумерованные списки, таблицы, разделители, блоки кода и цитаты.

• Не добавляйте и не удаляйте пробелы, пустые строки или разрывы строк.

• Не добавляйте и не удаляйте обратные кавычки, звездочки, квадратные скобки, круглые скобки, угловые скобки, фигурные скобки, косые черты, обратную косую черту, вертикальные черты, дефисы, подчеркивания, точки, запятые, точки с запятой, двоеточия, восклицательные знаки, вопросительные знаки, кавычки, апострофы, знаки @, знаки #, знаки $, знаки %, знаки ^, знаки &, знаки *, знаки +, знаки =, знаки ~, знаки , знаки |, знаки \, знаки /, знаки <, знаки >, знаки (, знаки ), знаки [, знаки ], знаки {, знаки }, знаки ., знаки ,, знаки ;, знаки :, знаки !, знаки ?, знаки ", знаки ', знаки @, знаки #, знаки $, знаки %, знаки ^, знаки &, знаки *, знаки +, знаки =, знаки ~, знаки , знаки |, знаки , знаки /, знаки <, знаки >, знаки (, знаки ), знаки [, знаки ], знаки {, знаки }, знаки ., знаки ,, знаки ;, знаки :, знаки !, знаки ?, знаки ", знаки '.

• Не добавляйте и не удаляйте HTML-теги.

• Не добавляйте и не удаляйте Markdown-форматирование.

• Не добавляйте и не удаляйте escape-последовательности.

• Не добавляйте и не удаляйте символы Unicode.

• Не добавляйте и не удаляйте эмодзи.

• Не добавляйте и не удаляйте ничего, что не является текстом.

• Не изменяйте порядок элементов.

• Не изменяйте количество элементов.

• Не изменяйте тип элементов.

• Не изменяйте атрибуты элементов.

• Не изменяйте значения атрибутов.

• Не изменяйте содержимое элементов.

• Не изменяйте структуру документа.

• Не изменяйте форматирование.

• Не изменяйте стиль.

• Не изменяйте язык.

• Не изменяйте кодировку.

• Не изменяйте что-либо еще.

Просто переведите текст.

Вот текст для перевода:

Система за 30 секунд

flowchart LR
    Idea["Your idea"] --> Client{"How do you want to work?"}
    Client -->|Create manually| UI["React studio"]
    Client -->|Delegate to an agent| MCP["MCP server"]

    UI --> API["Local API"]
    MCP --> API

    API --> Prompt["Editable prompt refinement"]
    API --> Router["Capability-aware router"]
    API --> Quote["Quote and pricing engine"]

    Prompt --> Router
    Router --> Prov["fal · Kling · Agnes · kie · inemaimg"]
    Prov --> Mirror["Local media mirror"]

    API --> Projects["Website and PDF runner"]
    Projects --> Archive["Inspectable project source"]

    Quote --> Ledger[("Local SQLite ledger")]
    Mirror --> Ledger
    Archive --> Ledger

Браузер никогда не получает секреты провайдера. Он взаимодействует с локальным сервисом, который проверяет полезные нагрузки для конкретных моделей, владеет учетными данными, передает прогресс в потоковом режиме, зеркалирует артефакты и записывает постоянные метаданные.

Выберите правильную стратегию подключения

Bench использует агрегатор, потому что одна модель аутентификации и очереди — это практичный способ поддержки большого, взаимозаменяемого каталога. Это не единственная допустимая архитектура.

flowchart TB
    Need{"What do you actually need?"}
    Need -->|One stable model| Direct["Use its first-party API"]
    Need -->|Many interchangeable models| Bench["Use Bench + an aggregator"]

    Direct --> D1["Potentially lowest route price"]
    Direct --> D2["One integration per provider"]
    Direct --> D3["Best for a narrow workflow"]

    Bench --> B1["One authentication and queue model"]
    Bench --> B2["Consistent controls and records"]
    Bench --> B3["Best for a flexible studio"]

Агрегатор не всегда может быть самым дешевым маршрутом. Bench делает этот компромисс явным, вместо того чтобы называть его «нулевой наценкой».

Один запрос, от идеи до квитанции

sequenceDiagram
    participant U as User or agent
    participant B as Bench
    participant R as Capability router
    participant F as fal.ai
    participant L as Local archive

    U->>B: Describe the result
    B->>R: Select a model and inspect accepted inputs
    R-->>B: Controls, limits, and pricing unit
    B-->>U: Editable prompt and preflight estimate
    U->>B: Approve generation
    B->>F: Validated model-specific payload
    F-->>B: Queue progress and output URL
    B->>L: Mirror media and write metadata
    B-->>U: Local result, provider result, and recorded cost

Bench записывает, что было отправлено. Он никогда не утверждает, что прикрепленный референс повлиял на результат только потому, что API принял поле; творческая достоверность по-прежнему требует проверки человеком.

Интеллект модели, а не выпадающий список, полный URL-адресов

У каждой конечной точки разные предположения. Некоторые принимают одно изображение, некоторые принимают список, некоторые требуют начальный кадр, а другие не принимают референсы. Bench держит обнаружение отдельно от допуска к производству:

flowchart LR
    Catalog["Live provider catalog"] --> Discover["Discovery snapshot"]
    Discover --> Evidence["Schema and pricing evidence"]
    Evidence --> Review{"Safe for production?"}
    Review -->|Not yet| Observe["Keep observable"]
    Review -->|Yes| Registry["Curated registry"]
    Registry --> UI["Relevant UI controls"]
    Registry --> MCP["Validated MCP inputs"]

Это предотвращает недавно опубликованную, переименованную или недостаточно описанную модель от незаметного нарушения платного рабочего процесса.

Уточнение запроса остается видимым

1. Напишите обычный творческий запрос.

2. Bench добавляет структуру, которую выбранная модель, вероятно, поймет.

3. Просмотрите переписанный запрос как редактируемый черновик.

4. Измените или отклоните его, прежде чем потратить что-либо.

5. Сохраните окончательный отправленный запрос вместе с результатом.

Если ключ Google не настроен, исходный запрос проходит без изменений, и интерфейс сообщает, что уточнение отключено.

Прозрачность стоимости без маркетинговой математики

Перед отправкой Bench оценивает стоимость на основе цены за единицу модели и запрошенных параметров. После завершения он записывает выставленную сумму, когда провайдер предоставляет достаточные данные квитанции.

flowchart LR
    Params["Model + duration + resolution + quantity"] --> Estimate["Preflight estimate"]
    Estimate --> Approval["Explicit approval"]
    Approval --> Run["Provider execution"]
    Run --> Record["Recorded cost + confidence"]

Цены меняются. Оценки не являются гарантиями. Bench различает оценочные, измеренные и записанные значения, вместо того чтобы представлять все три как один и тот же факт.

Ваша локальная граница данных

Репозиторий начинается без каталога data/. Bench создает его при первом запуске:

data/
├── bench.db              # generations, assets, spend, and projects
├── inputs/               # mirrored uploads
├── outputs/              # mirrored generations
├── previews/             # local video posters
└── projects/             # website and document source files

Весь каталог игнорируется Git. Удаление результата удаляет его локальную запись в базе данных и зеркальные файлы. Он не утверждает, что удаляет копии, сохраненные внешним провайдером модели.

flowchart LR
    Browser["Browser UI\nno provider keys"] --> Local["Loopback API\nkeys + validation"]
    Agent["Local MCP client"] --> Local
    Local --> Provider["External model provider"]
    Local --> Disk["Local SQLite + files"]

Используйте его из Claude, Codex или Cursor

Запустите Bench, откройте Connect, выберите свой клиент и скопируйте сгенерированную конфигурацию. Bench вставляет правильный абсолютный путь для текущей машины; сам репозиторий не содержит домашнего каталога пользователя.

Сервер MCP предоставляет одиннадцать целенаправленных инструментов для:

• обнаружения моделей и проверки контрактов возможностей;

• загрузки локальных референсных медиафайлов;

• генерации изображений и видео;

• чтения результатов, превью и расходов;

• создания и опроса проектов веб-сайтов или документов;

• получения локальных артефактов проекта.

Встроенный навык в integrations/skills/bench-studio/ предоставляет рекомендации по суждениям и рабочему процессу. MCP обеспечивает уровень выполнения в реальном времени.

Карта проекта

bench-studio-public/
├── src/                     # React interface
├── server/
│   ├── server.mjs           # loopback API and orchestration
│   ├── mcp.mjs              # stdio MCP server
│   ├── registry.json        # curated production roster
│   ├── capabilities.json    # accepted-input contracts
│   ├── profiles/            # prompt and pricing intelligence
│   └── mcp-app/             # embedded MCP interface
├── integrations/
│   ├── skills/bench-studio/ # portable agent workflow skill
│   └── macos/               # optional launch-agent templates
├── tests/                   # contracts, persistence, API, a11y, and E2E
├── docs/                    # public README media
├── .env.example             # placeholders only
└── package.json

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

Полезные команды

Безопасность и конфиденциальность

Позиция по умолчанию. Оба порта привязаны к loopback, и нет пароля — общение с собственной машиной не должно его требовать. Ничто не покидает вашу машину, кроме вызовов, которые вы делаете к настроенным вами провайдерам.

Ключи. Читаются на стороне сервера, никогда не возвращаются в UI. Экран конфигурации показывает наличие, источник и последние 4 символа — никогда не значение. .env записывается с правами только для владельца (600) и игнорируется git.

Необязательный пароль. Установите BENCH_PASSWORD, и API потребует сессию:

npm run set-password              # asks for it, without echoing
npm run set-password -- --remove

Хранится в виде scrypt-хэша, так что никто не прочитает ваш пароль из файла. Установка или изменение немедленно выходит из системы всех остальных. Забыли? Удалите строку из .env и перезапустите — это путь восстановления, намеренно, потому что тот, у кого есть этот файл, уже имеет ключи внутри него.

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

Запись настроек только с машины. Даже с действительной сессией POST к конечным точкам конфигурации отклоняется из сети — изменение ключей требует нахождения на машине. Это переживает прокси разработки: API доверяет только перенаправленному источнику, когда сокет уже является loopback, поэтому запрос из сети не может его подделать.

Экспонирование. ./scripts/remote.sh open публикует интерфейс и открывает порт; close отменяет и то, и другое. См. Доступ с другой машины и Безопасное оставление включенным. Предпочитайте Tailscale или защищенный паролем обратный прокси открытому порту.

• Сгенерированные медиафайлы могут по-прежнему сохраняться внешним провайдером в соответствии с условиями этого провайдера.

• Создание веб-сайта и документа может вызывать локально аутентифицированного агента кодирования. Просмотрите сгенерированный исходный код перед его развертыванием.

Прочтите SECURITY.md перед экспонированием, модификацией или распространением сервиса.

Честные границы

• Bench — это локальный инструмент для одного пользователя, а не размещенный мультитенантный SaaS-продукт.

• Реестр курируется намеренно; наличие в каталоге не гарантирует допуск к производству.

• Принятые входные данные не гарантируют творческую достоверность.

• Вывод веб-сайта статичен по замыслу.

• Создание PDF-файлов зависит от локальной установки Chrome.

• Доступность и цены моделей могут измениться после синхронизации каталога.

• Владение слоем означает поддержку небольшого фрагмента программного обеспечения.

Уверенность в релизе

Шлюз релиза охватывает производственные сборки, контракты API и базы данных, обнаружение MCP, браузерные сценарии, доступность, адаптивность, состояния сбоев, переходы моделей и визуальные снимки.

npm run test:release

Лицензия

Bench Studio Public доступен по лицензии MIT.

Модели выполняют тяжелую работу. Bench делает слой вокруг них видимым — и вашим.