SeeReel

Localhost Setup

Requirements:

• Node.js 22+
• npm

git clone https://github.com/feifeibear/seereel-agent.git
cd seereel-agent
npm install
cp .env.example .env
npm run dev

Open the printed local URL, usually:

http://localhost:5173

Production-style local run:

NODE_ENV=production PORT=5174 npm run start

Without provider keys, the app still opens and can be explored in mock mode. For real generation, configure API Keys and TOS.

Real Generation Setup

Default route: Volcengine Agent Plan. One Agent Plan key can cover SeeReel's Seedream image generation, Seedance video generation, and Seed/VLM review path through the dedicated /api/plan/v3 route.

ARK_AGENT_PLAN_KEY=<your-agent-plan-key>
ARK_AGENT_PLAN_BASE=https://ark.cn-beijing.volces.com/api/plan/v3
SEEDREAM_AGENT_PLAN_MODEL=doubao-seedream-5.0-lite
SEEDANCE_AGENT_PLAN_MODEL=doubao-seedance-2-0-260128
SEEDANCE_AGENT_PLAN_FAST_MODEL=doubao-seedance-2-0-fast-260128
VISION_REVIEW_AGENT_PLAN_MODEL=doubao-seed-2.0-pro
VIDEO_ANALYZE_AGENT_PLAN_MODEL=doubao-seed-2.0-pro

Preferred local route when available: standard Ark API keys. If BP, CN, and Agent Plan keys are all configured, SeeReel uses BP > CN > Agent Plan:

BP_ARK_API_KEY=<your-standard-ark-api-key>
BP_SEEDREAM_API_KEY=<optional-seedream-only-bp-key>
BP_SEEDREAM_API_BASE=https://ark.ap-southeast.bytepluses.com/api/v3
BP_SEEDANCE_API_KEY=<optional-seedance-only-bp-key>
BP_SEEDANCE_API_BASE=https://ark.ap-southeast.bytepluses.com/api/v3

CN_ARK_API_KEY=<your-cn-ark-api-key>
CN_SEEDREAM_API_KEY=<optional-seedream-only-cn-key>
CN_SEEDREAM_API_BASE=https://ark.cn-beijing.volces.com/api/v3
CN_SEEDANCE_API_KEY=<optional-seedance-only-cn-key>
CN_SEEDANCE_API_BASE=https://ark.cn-beijing.volces.com/api/v3
SEEDANCE_CN_MODEL=doubao-seedance-2-0

TOS is separate and still required when local or Codex-generated references must be sent to remote Seedance workers:

TOS_ACCESS_KEY_ID=<AK>
TOS_SECRET_ACCESS_KEY=<SK>
TOS_REGION=cn-beijing
TOS_ENDPOINT=tos-cn-beijing.volces.com
TOS_BUCKET=<bucket>
TOS_KEY_PREFIX=cinema-agent/storyboards
TOS_PRESIGN_EXPIRES_SEC=604800

Volcengine doubao-music is a separate OpenAPI service for the post-stitch audio-track node. It does not use Ark /api/v3 or Agent Plan credentials:

VOLC_MUSIC_ACCESS_KEY_ID=<AK>
VOLC_MUSIC_SECRET_ACCESS_KEY=<SK>
VOLC_MUSIC_BILLING_MODE=postpaid
VOLC_MUSIC_MODEL_VERSION=v5.0

Fallback and optional providers:

Public Deployment

The public product currently runs at:

https://seereel.studio

For your own deployment, the simplest production shape is one Volcengine ECS instance with Caddy, persistent storage, and either Docker Compose or systemd. See deploy/volcengine.md for the full runbook.

Do not put a personal Agent Plan key into a public frontend bundle. For a public server:

• Visitors paste their own Agent Plan token in the browser top bar.
• CLI users configure their own local token with seereelcli configure --agent-plan-token.
• Server-side free-trial keys, if enabled, must be stored as protected runtime configuration.
• Admin credentials and provider secrets must stay out of README screenshots, logs, frontend code, and GitHub.

Demo: Vibe Creating Through Chat

This 30-second one-shot drone route was created from a single chat request and one reference image. SeeReel generated the final video while keeping the production graph visible: uploaded reference, storyboard nodes, Seedance shots, a tail-frame continuity bridge, and the stitch node.

User input User input Use SeeReel. Reference this image and generate a 30-second first-person drone video that follows the route drawn in the image, as a single continuous shot.

Codex reply (GPT 5.5) Done. The SeeReel session is: Handoff link Session: ses_f65954c9 Final cloud download: https://seereel.studio/api/sessions/ses_f65954c9/download Final video preview: Canvas: Validation result: 30.167s, 720x1280, 6.0 MB MP4 preview. SeeReel confirms that both shots are ready, stitch is ready, and there are 0 failed shots. The workflow keeps the uploaded reference image, two cloud storyboard segments, two 15s Seedance shots, shot 1's tail-frame asset asset_4166c2e4, and shot 2 is configured with firstFrameAssetId=asset_4166c2e4 for first-frame continuity. Apart from uploading the user's local reference image and downloading the final video locally, all intermediate results were generated in the SeeReel cloud and kept in the session.

The handoff link opens this session's workflow in the SeeReel web app.

The user does not only watch the final video. They can return to this canvas, revise the reference image, prompt, storyboard, generated shots, first-frame continuity bridge, or stitch node, and then continue production from the edited point.

Reference image source: 4K Wallpapers.

API Surface

The web UI, CLI, and agents share the same API and persisted state.

See AGENTS.md and .agents/skills/seereel-agent-session/reference.md for operating details.