PAI-Pro
The local AI filmmaking studio, driven from your coding agent.
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, and voice, 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 myPAI_KEY, use Docker unless I ask for local development, and start the app when setup is complete.
| Choose | Commands |
| --- | --- |
| Claude Code | Docker: ./scripts/docker-start.shLocal: if ports are busy, run ./scripts/stop.sh first; then ./scripts/setup --agent claude and ./scripts/start.sh |
| Codex | Docker: PAI_DEFAULT_AGENT_ID=codex ./scripts/docker-start.shLocal: 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, and voice, without separate provider keys for each step. Use the PAI Pro Developer Platform 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 |
| 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.