Bench Studio

래퍼를 빌리는 것을 멈추세요. 창작 레이어를 소유하세요.

이미지, 비디오, 웹사이트, 디자인된 PDF, AI 에이전트 워크플로를 위한 로컬 우선 창작 스튜디오.

빠른 시작 · 시간과 비용을 절약해주는 팁 · 심층 작동 원리 · 변경 사항 및 이유 · 보안

Bench Studio는 5개 공급업체의 73개 선별된 이미지 및 비디오 경로, 프롬프트 개선, 기능 인식 컨트롤, 로컬 파일 보관, 투명한 비용 원장을 하나의 인터페이스 뒤에 제공합니다. 동일한 시스템이 MCP를 통해 Claude, Codex, Cursor 및 기타 호환 클라이언트에서 사용 가능합니다.

키는 서버 측(귀하의 기기)에 유지됩니다. 프롬프트는 비용을 지불하기 전에 편집할 수 있습니다. 출력물은 로컬에 미러링됩니다. 비용은 신비한 크레딧으로 사라지지 않고 실제 단위로 기록됩니다.

[!NOTE] 이는 정리된 공개 배포판입니다. 생성 기록, 업로드, 개인 데이터베이스, 개인 경로, 자격 증명 또는 로컬 빌드 아티팩트 없이 제공됩니다. 귀하의 아카이브는 빈 상태로 시작됩니다.

📖 Guia de uso

전체 가이드(랜딩 페이지 + 단계별 안내): https://inematds.github.io/bench-studio-en/guia/

Related MCP server: omnicinema-mcp

존재 이유

대부분의 창작 AI 제품은 다섯 가지 유용한 요소(모델 접근, 프롬프트 다듬기, 라우팅, 저장, 청구)를 결합한 후, 그 이음새를 월간 요금제 뒤에 숨깁니다. Bench는 편리함을 유지하면서 모든 이음새를 검사 가능하게 만듭니다.

Bench는 기본 모델을 소유하지 않습니다. 아이디어, 도구, 공급업체, 파일 및 비용을 연결하는 휴대용 레이어에 대한 소유권을 제공합니다.

3분 안에 실행하기

필요한 것

필수

• Node.js 22.5+; Node 24 권장(Bench는 node:sqlite를 사용함).

• npm.

이것이 전부입니다. 모든 공급업체는 선택 사항이며 각각 독립적으로 저하됩니다. 키가 없으면 해당 모델을 사용할 수 없음으로 표시하고 이유와 해결 방법을 알려줍니다. 스튜디오는 여전히 시작됩니다. 무엇이든 생성하려면 다음 중 하나 이상을 가져오세요:

선택 사항이지만 가치 있음

• 프롬프트 개선을 위한 Google AI Studio 또는 OpenRouter 키. 개선기가 없으면 프롬프트가 원시 상태로 전송됩니다. Agnes는 영어가 필요하므로 거부합니다.

• PDF 인쇄 및 시각적 사전 점검을 위한 Google Chrome.

• 에이전트 기반 웹사이트 및 문서 빌드를 위한 로그인된 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는 gitignored이며 소유자 전용 권한으로 작성됩니다.

읽기 순서(가장 높은 우선순위):

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

다른 기기에서 접근하기

두 포트 모두 루프백에 바인딩되므로, 새로 설치하면 아무도 응답하지 않습니다. 이를 열려면 세 가지 작업이 필요합니다. 인터페이스가 모든 인터페이스에서 수신 대기하도록 설정, 방화벽 규칙 추가, 그리고 두 작업을 다시 되돌리는 것을 기억하는 것입니다. 하나의 명령어로 세 가지를 모두 수행합니다:

./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을 응답하며, 세션 유무와 관계없이 그렇습니다. Config 화면은 비활성 필드를 보여주는 대신 이 사실을 표시합니다. 이 규칙은 열린 포트를 찾은 사람이 자신의 암호를 설정하여 스튜디오를 잠그는 것을 막습니다. 따라서:

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

open이 의도적으로 하지 않는 일: API를 공개합니다. 포트 8787은 루프백(BENCH_API_HOST)에 유지되므로, 파일을 쓰고 비용을 지출하는 엔드포인트는 인터페이스를 통해서만, 기기 자체에서만 접근할 수 있습니다.

이는 테스트 자세이지 배포가 아닙니다. 트래픽은 일반 HTTP이며 전송 중에 읽을 수 있습니다. 장기간 유지되는 항목에 대해서는 다음 섹션을 읽으세요.

안전하게 유지하기

실제로 보호해주는 순서대로:

1. 설치 시 암호를 설정하세요. 접근 가능한 기기에서는 설정 절차의 일부로 만드세요. npm install, npm run set-password, ./scripts/remote.sh open 순서로 수행합니다. 이 순서로 하면 스튜디오가 암호 없이 열리는 일이 없으며, 네트워크에서 사용할 수 없는 암호 화면이 필요하지 않습니다.

2. API를 루프백에 유지하세요. 기본값입니다. BENCH_API_HOST=0.0.0.0은 이유가 있는 경우에만 선택 해제해야 합니다.

3. 접근 가능한 범위를 좁히세요. ./scripts/remote.sh open --ip <your-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로 프록시하고 npm run build의 dist/를 사이트로 제공하세요. 그런 다음 5200을 완전히 닫으세요. 이렇게 하면 프록시가 X-Forwarded-For를 보내도록 하세요. 아래의 기기 전용 규칙이 이에 의존합니다.

6. 루트가 아닌 자체 사용자로 실행하세요. systemd 유닛 아래에서, .env는 600 권한으로 유지하세요. 이것이 스튜디오가 작성하는 방식입니다.

7. 테스트가 끝나면 닫으세요. ./scripts/remote.sh close. 잊어버린 노출이 공급업체 크레딧을 소모하게 만듭니다.

시간과 비용을 절약해주는 팁

무료 경로로 시작하세요. Agnes(4개 모델)와 inemaimg(2개, 자체 GPU 사용)는 비용이 없습니다. Model catalog에서 No cost 스위치는 정확히 해당 그룹을 켭니다. 이를 사용하여 작동하는 프롬프트를 찾은 다음, 가장 잘 렌더링하는 모델에 비용을 지출하세요.

카탈로그를 한 번 선별하세요. 73개 모델은 스크롤하기에 많습니다. 공급업체별로 필터링한 다음 "Disable those N"을 사용하여 사용하지 않을 모델을 숨기세요. 선별은 기본 설정이지 차단이 아닙니다. 선택기에서 모델을 숨기지만 이전 결과의 Redo는 여전히 작동합니다. data/catalog-prefs.json을 삭제하면 공장 상태로 복원됩니다.

지출 전에 개선하세요. 개선된 프롬프트는 제출 전에 편집 가능합니다. 읽어보세요. 오해를 잡을 수 있는 가장 저렴한 장소입니다. 제출 후에는 수정에 또 다른 실행 비용이 듭니다.

두 개의 개선기를 구성해 두세요. 체인은 Gemini → OpenRouter → local Codex입니다. 하나만 있으면 할당량이 소진되었을 때 전체 스튜디오가 다운됩니다. 프롬프트가 원시 상태로 전달되고 Agnes가 영어가 아닌 것을 거부하여 Agnes 문제처럼 보이지만 실제로는 그렇지 않은 오류가 발생합니다.

다시 입력하지 말고 Redo를 사용하세요. 모든 결과는 모델, 컨트롤, 개선된 프롬프트, 원래 아이디어 및 첨부 파일을 포함합니다. Redo는 모든 것을 복원하므로 다시 작성하는 비용 없이 한 가지만 조정할 수 있습니다.

동일한 모델이 두 경로에 존재할 수 있습니다. Veo, Nano Banana, gpt-image 및 gemini-image는 여러 공급업체를 통해 나타납니다. 각각 다른 청구 방식(fal에서는 달러, Kling에서는 요금제 크레딧)이 적용됩니다. 선택기에서 공급업체가 이름 옆에 표시됩니다. 이는 중복이 아니라 실제 선택입니다.

Kling은 의도적으로 자동 재시도를 하지 않습니다. 모든 Kling 작업은 실패를 포함하여 청구됩니다. 사용자 모르게 재제출되지 않습니다.

CPU가 아닌 디스크를 주시하세요. 모든 파일은 공급업체 URL이 만료되므로 로컬에 미러링됩니다. (Kling은 24시간, Agnes는 임시). 이미지당 약 1.3MB, 비디오당 0.7–5MB입니다. 스튜디오는 유휴 상태에서 274MB의 RAM을 사용합니다.

웹사이트를 구축 중이신가요? 에이전트를 선호하세요. Codex와 Claude Code는 파일을 직접 작성하고 자신의 실수를 수정합니다. 모델 엔진(로컬 Qwen, OpenRouter)은 텍스트만 반환하므로 샌드박스가 필요 없고 비용이 들지 않지만, 더 많은 감독이 필요합니다.

소유한 참조 자료를 빌더에 지정하세요. Config에서 자신의 사이트나 PDF를 설정하면 빌더가 그에 맞춰 마무리 작업을 조정합니다. 토큰, 글꼴, 팔레트, 반경 등이 포함됩니다. 브랜드, 카피, 구조 또는 파일을 복사하지 않습니다.

만들 수 있는 것

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는 하나의 인증 및 큐 모델이 대규모 교체 가능한 카탈로그를 지원하는 실용적인 방법이기 때문에 집계자(aggregator)를 사용합니다. 이것이 유일한 유효한 아키텍처는 아닙니다.

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는 발견(discovery)과 프로덕션 허용(production admission)을 분리합니다:

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 서버는 다음을 위한 11개의 집중된 도구를 제공합니다:

• 모델 발견 및 기능 계약 검사;

• 로컬 참조 미디어 업로드;

• 이미지 및 비디오 생성;

• 결과, 미리보기 및 지출 읽기;

• 웹사이트 또는 문서 프로젝트 생성 및 폴링;

• 로컬 프로젝트 아티팩트 검색.

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

문서

유용한 명령어

보안 및 개인정보 보호

기본 자세. 두 포트 모두 프백에 바인딩되며 비밀번호가 없습니다 — 자신의 머신과 통신하는 데 비밀번호가 필요하지 않습니다. 구성한 공여자에게 보내는 호출 외에는 아무것도 머신을 떠나지 않습니다.

키. 서버 측에서 읽히며, 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는 소켓가 이 프백일 때만 전달된 원을 신뢰하므로, 네트워크의 요청은 이를 위조할 수 없습니다.

노출. ./scripts/remote.sh open은 인터페이스를 게시하고 포트를 엽니다. close는 둘 다 취소합니다. 다른 머신에서 접근하기 및 [안전하게 계속 실행하기](#안전하게-계속 실행하기)를 참조하십시오. 열린 포트보다 Tailscale 또는 비밀번호로 보호된 역 프록시를 선호하십시오.

• 생성된 미디어는 해당 공급자의 약관에 따라 외부 공급자가 보유할 수 있습니다.

• 웹사이트 및 문서 생성을 통해 로컬 인증된 코딩 에이전트를 호출할 수 있습니다. 배포하기 전에 생성된 소스를 검토하십시오.

서비스를 노출, 수정 또는 제분배하기 전에 SECURITY.md를 읽으십시오.

정직한 경계

• Bench는 로컬 단사용자 도구입니다 — 호스티드 멀티테넌트 SaaS 제품이 아닙니다.

• 레지스트리는 의도적으ᅳ커ᅳᅩ 큐레이션되며, 카탈로그 존재가 프로덕션 허용을 보장하지 않습니다.

• 수락된 입력이 창의적 충실도를 보장하지 않습니다.

• 웹사이트 출력은 기본적으로 정적입니다.

• PDF 생성은 로컬 Chrome 설치에 의존합니다.

• 모델 가용성 및 가격은 카탈로그 동기화 후 변경될 수 있습니다.

• 레이어를 소유한다는 것은 작은 소프트웨어를 유지 관리해야 함을 의미합니다.

릴리스 신뢰도

릴리스 게이트는 프로덕션 빌드, API 및 데이터베이스 계약, MCP 검색, 브라우저 여정, 접근성, 반응형 컨테인먼트, 실패 상태, 모델 전환 및 시각적 스냅샷을 다룹니다.

npm run test:release

라이선스

Bench Studio Public은 MIT 라이선스에 따라 제공됩니다.

모델이 무거운 작업을 수행합니다. Bench는 그 주변 레이어를 보이게 만듭니다 — 그리고 당신의 것입니다.