<div align="center">

PAI-Pro

The local AI filmmaking studio, driven from your coding agent.

简体中文 · English

Try the hosted web service

<br />

<img src="docs/assets/canvas_view.webp" alt="PAI-Pro canvas view" width="100%" /> </div>

What's PAI-Pro?

PAI-Pro is a local-first AI filmmaking workspace built around four things:

• Your own Claude Code or Codex, capable agents connected to local project files, persistent context, and customized filmmaking skills. (Setup and agents)
• End-to-end filmmaking skills for scripts, images, videos, and voice. (More skill details)
• A visual canvas and timeline for designing scenes, managing assets, arranging shots, and keeping larger productions organized.
• One API service for story media across image, video, voice, and 4K upscaling, so productions do not need separate providers for each step. (API service details)

Quick start

Use Claude Code or Codex to install PAI-Pro for you. Paste this into your agent:

Clone https://github.com/Utopai-Research/pai-pro, read the setup docs in README.md and docs/setup.md, then install PAI-Pro for my current agent. Ask me for my PAI_KEY, use Docker unless I ask for local development, and start the app when setup is complete.

Choose	Commands
<img src="https://cdn.jsdelivr.net/npm/simple-icons/icons/anthropic.svg" alt="Anthropic" width="16" height="16" /> Claude Code	Docker: ./scripts/docker-start.sh<br />Local: if ports are busy, run ./scripts/stop.sh first; then ./scripts/setup --agent claude and ./scripts/start.sh
<img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/openai/light.svg" alt="OpenAI" width="16" height="16" /> Codex	Docker: PAI_DEFAULT_AGENT_ID=codex ./scripts/docker-start.sh<br />Local: if ports are busy, run ./scripts/stop.sh first; then ./scripts/setup --agent codex and PAI_DEFAULT_AGENT_ID=codex ./scripts/start.sh

Open Docker at http://localhost:7588 or local at http://localhost:7443.

API Service

PAI_KEY gives each production one service for image, image pro, video, voice, and 4K upscaling, without separate provider keys for each step. Use the <a href="https://pai-pro.utopaistudios.com/keys" target="_blank" rel="noopener noreferrer">PAI Pro Developer Platform</a> to manage keys, tasks, balance, and credits. It also supports less restrictive video moderation via asset preupload and helps support this project. Paid generations are staged first; for BYOK and exact payloads, see API Service.

Capability	Quality	Time	# of references	Estimated price
generate_image	Great	~10-30s	16 imgs	$0.07 / $0.10 / $0.15 for 1K / 2K / 4K
generate_image_pro	Best	~3-6 min	32 imgs	$0.26 / $0.45 / $0.77 for 1K / 2K / 4K
generate_video	Best	~3-6 min	9 imgs / 3 vids / 3 auds	$0.08/s / $0.20/s / $0.44/s for 480p / 720p / 1080p
upscaler	Best	1-min example: ~4-8 min landed	1 video	1-min example: $1.35 for 1080p->4K, $2.35 for 720p->4K
generate_voice	Good	~5-15s	N/A	$0.01 per 500 input characters, rounded up

Resources

• 💬 Discord — questions, ideas, support, and show & tell
• ⚙️ API Service — developer platform notes, BYOK counterparts, and exact media JSON payloads
• 🎬 Skills reference — how filmmaking skills route agent requests
• 🚀 Setup and agents — choose Docker or host mode, configure Claude/Codex, and understand ports, auth, and permissions
• 🏗 Architecture — viewer, CLI, canvas, and project-file layout
• ❓ FAQ — common setup and generation issues
• 🐛 Issues — bug reports only
• 🤝 Contributing — contribution guide, proprietary-skills carve-out, and CLA flow

License

PAI-Pro is released under the PAI PRO Sustainable Use License, which permits personal use, non-commercial research, and internal business use. Commercial use of PAI-Pro Skills or enterprise-designated source code/Skills requires an explicit agreement; enterprise licenses are available.