Studio is an entertainment company built on an autonomous AI studio. Its original worlds, characters and stories are made by a durable, auditable production engine, and released to audiences on Studio. The founder directs the studio from the Studio console.
This is a working system. One brief goes all the way through, persisted at every step:
- Concepts are generated, scored and greenlit.
- The canon bible, pilot script, storyboard and an FFmpeg animatic are produced.
- QA reviews the result and the founder approves it.
- It's published to Studio.
- Real audience events come back in.
- A statistically honest experiment proposal follows.
See docs/ARCHITECTURE.md for the design, data model, integration matrix and phased plan.
Requirements:
- Node 22
- PostgreSQL 16
- FFmpeg with libx264, libvpx-vp9, libopus and libass (or set
FFMPEG_PATHtonode_modules/ffmpeg-static/ffmpeg)
cp .env.example .env # set DATABASE_URL (and optionally provider keys)
npm install # also runs `prisma generate`
npm run db:migrate # apply migrations
npm run db:seed # settings, founder account, agents, channels, schedules
npm run dev:all # web app + engine worker- Studio: http://localhost:3000
- the Studio console: http://localhost:3000/os. Sign in with
WEBSTER_FOUNDER_EMAIL/WEBSTER_FOUNDER_PASSWORD; the seed defaults toadmin@studio.local/studio-dev.
In production, run npm run build && npm start, plus one or more npm run worker processes.
The repo is one standard Next.js app, so Vercel imports it as a single project with no vercel.json. On Vercel, Studio adapts by itself:
- No worker process. The engine runs inside the app (
WEBSTER_ENGINE=inline). While someone is signed in to the Studio console, it keeps calling/api/engine/tick, and audience traffic on Studio nudges it too. To also run schedules when nobody is around, point a scheduler atGET /api/engine/tickwithAuthorization: Bearer $CRON_SECRET. - No object storage. Media is stored in Postgres (
STORAGE_DRIVER=db). - No system FFmpeg or fonts. It uses the bundled
ffmpeg-staticbuild and the DejaVu fonts inassets/fonts. - No manual database step.
npm run buildruns migrations and the seed beforenext build.
No database at all? It still runs: without DATABASE_URL, Studio starts a built-in in-memory Postgres (PGlite), migrates and seeds it, and opens the Studio console without sign-in (everyone is the demo founder; sign-in comes back once a real database is connected). It's fully usable, but everything resets when the server restarts, and Vercel may run more than one instance, so treat it as a try-out. The same works locally: just leave DATABASE_URL unset.
To keep your data:
- Import the repo on Vercel.
- Under Optional Integrations, add Prisma Postgres. It sets
DATABASE_URL. - Add environment variables:
WEBSTER_FOUNDER_EMAILWEBSTER_FOUNDER_PASSWORDWEBSTER_SECRET_KEY(openssl rand -base64 32)- optionally
ANTHROPIC_API_KEY
- Deploy, then sign in at
/os.
Each tick is limited to ~50 seconds, and a job cut off mid-way is retried when its lease expires.
In Founder Copilot, type:
Develop five original fantasy franchises for young adults and prototype the two strongest concepts.
Then:
- Watch it on the Studio Floor.
- Greenlight two concepts in the Approval Inbox.
- Approve the two publications.
- Open Studio.
After people watch, use Intelligence → Review now to get findings and an experiment proposal.
Expansion (Phase 2). Use a franchise's Director & roadmap → Start development cycle, or turn on the flywheel in Settings. Franchise Development proposes episodes, comics and interactive stories with measured cost estimates. You pick what to make, and each production ships through its own QA and publication gates. Character edits go through canon-change approval and flag dependent assets for review.
npm run slice (and node scripts/phase2.mjs for expansion) drives all of this in a browser and writes screenshots to docs/screenshots/. It needs a running app and worker. Its viewer sessions are tagged as QA traffic.
Everything runs. Writing agents use a deterministic DEMO generator, which you can turn off in Settings:
- It is labelled DEMO everywhere: OS, WORLD, disclosures and the database.
- It is never published to external platforms.
Storyboards and key art come from Studio's in-house procedural renderer. It isn't AI generation, and it's labelled as such.
Add ANTHROPIC_API_KEY (or store it encrypted from Settings) for real writing on claude-opus-5-5. Add OpenAI, ElevenLabs and YouTube credentials to enable AI imagery, licensed voices and external publishing. Missing integrations are never faked: their jobs block with setup instructions, or their publications are recorded as skipped.
npm test # unit + integration tests against Postgres (TEST_DATABASE_URL) with real FFmpeg
npm run typecheck
npm run buildThe integration tests cover:
- queue leasing, retry and dead-lettering;
- budget caps and the circuit breaker;
- workflow retry, block and resume;
- missing-credential blocking;
- autonomy policy;
- the full vertical slice, from brief to experiment proposal.
CI runs on GitHub Actions with a Postgres service.
app/(world)/ Studio (consumer)
app/os/ the Studio console (founder command center) + server actions
app/api/ media (Range), world events, auth
engine/ workflows, queue, worker, metering, policy, canon, agents,
providers (llm/image/voice), media (ffmpeg/render), channels, analytics, learning
prisma/ schema, migrations, seed
tests/ vitest unit + integration
