Skip to content
Back to search

pai-code

Local AI filmmaking studio — skills, canvas, timeline — driven from your coding agent.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/utopai-research--pai-code/badge.svg)](/listings/utopai-research--pai-code)

HTML

<a href="/listings/utopai-research--pai-code"><img src="/api/listings/utopai-research--pai-code/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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

> Clone [`https://github.com/Utopai-Research/pai-pro`](https://github.com/Utopai-Research/pai-pro), read the setup docs in [README.md](README.md) and [docs/setup.md](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/gh/glincker/thesvg@main/public/icons/openai/light.svg" alt="OpenAI" width="16" height="16" /> **[Codex][codex-url]** (default) | Docker: `./scripts/docker-start.sh`<br />Local: if ports are busy, run `./scripts/stop.sh` first; then `./scripts/setup` and `./scripts/start.sh` | | <img src="https://cdn.jsdelivr.net/npm/simple-icons/icons/anthropic.svg" alt="Anthropic" width="16" height="16" /> **[Claude Code][claude-code-url]** | Docker: `PAI_DEFAULT_AGENT_ID=claude ./scripts/docker-start.sh`<br />Local: if ports are busy, run `./scripts/stop.sh` first; then `./scripts/setup --agent claude` and `PAI_DEFAULT_AGENT_ID=claude ./scripts/start.sh` |

Either way, a project's agent can be changed at any time from the control in the terminal panel's header — the choice above only sets what a *new* project starts with.

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 24 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "pai-pro",
  3. "owner": {
  4. "name": "Utopai Research",
  5. "url": "https://github.com/Utopai-Research"
  6. },
  7. "plugins": [
  8. {
  9. "name": "pai-pro",
  10. "source": "./",
  11. "description": "Filmmaking skills for Claude Code: scripts, characters, locations, storyboards, clips, voices, and a local canvas to assemble them.",
  12. "version": "0.1.0",
  13. "skills": [
  14. { "name": "add-note", "path": "skills/add-note", "invoke": "/pai-pro:add-note" },
  15. { "name": "groups-compose", "path": "skills/groups-compose", "invoke": "/pai-pro:groups-compose" },
  16. { "name": "image-compose", "path": "skills/image-compose", "invoke": "/pai-pro:image-compose" },
  17. { "name": "script-compose", "path": "skills/script-compose", "invoke": "/pai-pro:script-compose" },
  18. { "name": "show-dag", "path": "skills/show-dag", "invoke": "/pai-pro:show-dag" },
  19. { "name": "video-compose", "path": "skills/video-compose", "invoke": "/pai-pro:video-compose" },
  20. { "name": "voice-compose", "path": "skills/voice-compose", "invoke": "/pai-pro:voice-compose" }
  21. ]
  22. }
  23. ]
  24. }
README.md · README · 76 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. # PAI-Pro
  3. **The local AI filmmaking studio, driven from your coding agent.**
  4. [简体中文](README.zh-CN.md) · [English](README.md)
  5. [Try the hosted web service](https://pai.utopai.film/)
  6. [![Utopai Studios](https://img.shields.io/badge/Utopai_Studios-4285F4?style=flat&logo=data%3Aimage/png%3Bbase64%2CiVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAACXBIWXMAAAsTAAALEwEAmpwYAAAAAXNSR0IArs4c6QAAAARnQU1BAACxjwv8YQUAAAXeSURBVHgB7VdpSJVpFD5edTSzzWnTMiWXaBHHomUoarSoTLJ%2B9KOBghZqSutHA6E/IqmpoYggiakgKhuKYkBIEqOgZaaMImghmjbNxBZiTMXUTK/3zPMc7/241U0dmOhPB16%2B977b2Z7zvO8V%2BSpfWIJ6OB%2BBljVixIjsxMTEpF69ekU0NDQ037t3rwLfYsyVonV413rkf5JgtG8HDRpUc/HiRY%2BqeiAaSM6fP6%2BjR4%2BuwvpU775Ajri8fVdPleedPn2aGjsg2pXQMLfbrZcvX3ZjX/kHinxR/GPdunV14eHh8dJN5Kn89/b2djcP7Urevn2rb968sdbc3Kytra0cbj916pTyDLRQKIxD6v4ZP358x9atW3Xu3LkVGA/vSvmv7k4J6Cmlrq5OYaBevXrVlNbW1urhw4c1KytLp0yZovPnz9cTJ064IyIicsaMGaNBQUHEhY3TaPRjAylnWGJgvedTngNwWlNTY4a8fv1aN2/erPCQCnjoR23hwoUKwHb4fl%2B4cEGrq6v1U967%2Bvbte5M5D6S8srLSvCYezp07p2FhYepyuQIq9rW8vDynDyP/wjcD7ScJAERD7pEjR9QHOEbh3bt31p80aZKWlpba3NixY00xvfb3PFAUQkJCHCO9xkT4RbvTa%2B%2B3gwdkZGS4EV4bePnypWCzDBw4UJBHQSglODhYHjx4IFwDu2TAgAGyZcsWOX78uMyaNUugsPNQV%2BexcEJ2794tkZGRcu3atY7U1NRmrNfMzMxqTP/mH4lkbPJcuXJFb926pYsXL9a9e/fqtGnTtKWlRefMmeN47fP20KFDBsBHjx4pUK4PHz7UGzdu6IsXLzQ7O9uJQklJifbv39%2BigRRrQkKCnjlzxqLqn4JQ5pTWURkV9OnTR58/f26H79%2B//71QA926Z8%2BeT4Z/9erVztiaNWtM2YQJE0z5smXLDMTetU4ImO/cAwcOyNOnT20AvwVlJqtWrRIc5ljK0N%2B5c0eKioqccPfr108QCZtjuMvKyqxPuXTpktTX18vjx48FkZC4uDgBZ3Cqzd8ANw4p4ERjY6Pluq2tTZKTkyUmJkYqKiqcvDLvT548sdxTVq5cKQipJCUlyYoVKwwHoO9OpMFwYgnRFZCVGREfH29OonwbuSbE5xmUtnCSoHv16pUUFhbK0qVL5fbt25Kenm7AQxXYgcOGDZP79%2B/LsWPHZOTIkWY0PT169Kjk5uYKytX2UZBC7mvFuU2jRo2KxL4wRCQI%2BCnxxwA9bN61a5flBh5oVFSURkdHW%2BnBa4WBTo5nzpxpYOvdu7eCYhUh16FDh1neiRkoctbOmzePZxXJx/IeF4QSWEQr6ZIbUSr2JdMRVAQSK8HfEDZS7fbt2/Xs2bMG4okTJ743n5%2Bfz%2B%2BP0o24kKef6QGwoCdPnnQYcMeOHQ6pbNy4UdPS0uw3jdm0aZNev35dgRcjLl5CBQUFjpE8b%2B3atSSW6K6UB%2BGwQix2g%2Bc9LBtuZgrI9T7ZsGGD1THyp8CILliwwNYBD4qqUHLI3bt3FTm28YMHD/LrmTp1aq109/CBAQ3Dhw/3AEx2MIX5ffbsmfV58fiEngNodinxBsT1arUNkFmaFi1a5HDAvn37%2BE2Qbh4hnEz0crabB5GUfGGkkA3pGe/8nJwciw7nUNNaXFxsfbyIdMmSJbpz507dtm2bLl%2B%2BnJcXw/%2BL9EBoxDdU7LOeFUD0sz99%2BnRTVFVVZcb4hAj3GYn7wCh8yJAhDgBDQ0P5zZQePsNkxowZleJHrQQeD6ExsbGxOnjwYAUPWAky7KyO8vJySxUfI4zM7NmzCTzr4z3gWb9%2BfX1XOoM%2BiILP%2BnS0fKTlh3Hjxn2DfAsMMSLCi0YQBYFBAjIxguJv3nxkQZIQx8impGX8Tmlqavpb/uNr%2BUPDvkMj995EXbeCSu1xwhIkWFNSUowvGDFGj6RER3Ch/SmfUaLQvocB%2BZMnTy5DvxIGtODdYEYwbbhH0qT7/x6fTcKkp%2BD7Kl9S/gWQAm5AIYveoQAAAABJRU5ErkJggg%3D%3D&logoColor=white)](https://www.utopaistudios.com/)
  7. [![Discord][discord-shield]][discord-url]
  8. [![Follow @UtopaiStudios](https://img.shields.io/badge/Follow-%40UtopaiStudios-000000?style=flat&logo=x&logoColor=white)](https://x.com/UtopaiStudios)
  9. <br />
  10. [![Claude Code supported](https://img.shields.io/badge/Claude_Code-supported-2EA44F?style=flat&labelColor=D97757&logo=anthropic&logoColor=white)][claude-code-url]
  11. [![Codex supported](https://img.shields.io/badge/Codex-supported-2EA44F?style=flat&labelColor=111111&logo=data%3Aimage%2Fsvg%2Bxml%3Bbase64%2CPHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCA2NCA2NCI%2BPGcgZmlsbD0ibm9uZSIgc3Ryb2tlPSIjZmZmIiBzdHJva2Utd2lkdGg9IjUuNSIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBzdHJva2UtbGluZWpvaW49InJvdW5kIj48cGF0aCBkPSJNMzIgOGM2LjIgMCAxMS40IDMuMiAxNC4zIDguMUwzMiAyNC40IDE3LjcgMTYuMUMyMC42IDExLjIgMjUuOCA4IDMyIDhaIi8%2BPHBhdGggZD0iTTUwLjIgMTguM2M1LjQgMy4xIDguMSA4LjggNy44IDE0LjVsLTE0LjMtOC4zVjguMWMyLjUgMS4yIDQuOCAzLjEgNi41IDEwLjJaIiB0cmFuc2Zvcm09InJvdGF0ZSg2MCAzMiAzMikiLz48cGF0aCBkPSJNNTAuMiAxOC4zYzUuNCAzLjEgOC4xIDguOCA3LjggMTQuNWwtMTQuMy04LjNWOC4xYzIuNSAxLjIgNC44IDMuMSA2LjUgMTAuMloiIHRyYW5zZm9ybT0icm90YXRlKDEyMCAzMiAzMikiLz48cGF0aCBkPSJNNTAuMiAxOC4zYzUuNCAzLjEgOC4xIDguOCA3LjggMTQuNWwtMTQuMy04LjNWOC4xYzIuNSAxLjIgNC44IDMuMSA2LjUgMTAuMloiIHRyYW5zZm9ybT0icm90YXRlKDE4MCAzMiAzMikiLz48cGF0aCBkPSJNNTAuMiAxOC4zYzUuNCAzLjEgOC4xIDguOCA3LjggMTQuNWwtMTQuMy04LjNWOC4xYzIuNSAxLjIgNC44IDMuMSA2LjUgMTAuMloiIHRyYW5zZm9ybT0icm90YXRlKDI0MCAzMiAzMikiLz48cGF0aCBkPSJNNTAuMiAxOC4zYzUuNCAzLjEgOC4xIDguOCA3LjggMTQuNWwtMTQuMy04LjNWOC4xYzIuNSAxLjIgNC44IDMuMSA2LjUgMTAuMloiIHRyYW5zZm9ybT0icm90YXRlKDMwMCAzMiAzMikiLz48L2c%2BPC9zdmc%2B&logoColor=white&logoWidth=16)][codex-url]
  12. [discord-shield]: https://img.shields.io/badge/Discord-Join-green?style=flat&logo=discord&logoColor=white
  13. [discord-url]: https://discord.gg/hb4MkHND
  14. [claude-code-url]: https://code.claude.com/docs/en/overview
  15. [codex-url]: https://developers.openai.com/codex/cli
  16. <img src="docs/assets/canvas_view.webp" alt="PAI-Pro canvas view" width="100%" />
  17. </div>
  18. ## What's PAI-Pro?
  19. PAI-Pro is a local-first AI filmmaking workspace built around four things:
  20. - **Your own [Claude Code][claude-code-url] or [Codex][codex-url]**, capable agents connected to local project files, persistent context, and customized filmmaking skills. ([Setup and agents](docs/setup.md))
  21. - **End-to-end filmmaking skills** for scripts, images, videos, and voice. ([More skill details](docs/skills.md))
  22. - **A visual canvas and timeline** for designing scenes, managing assets, arranging shots, and keeping larger productions organized.
  23. - **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](docs/api_service.md))
  24. ## Quick start
  25. Use Claude Code or Codex to install PAI-Pro for you. Paste this into your agent:
  26. > Clone [`https://github.com/Utopai-Research/pai-pro`](https://github.com/Utopai-Research/pai-pro), read the setup docs in [README.md](README.md) and [docs/setup.md](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.
  27. | Choose | Commands |
  28. | --- | --- |
  29. | <img src="https://cdn.jsdelivr.net/gh/glincker/thesvg@main/public/icons/openai/light.svg" alt="OpenAI" width="16" height="16" /> **[Codex][codex-url]** (default) | Docker: `./scripts/docker-start.sh`<br />Local: if ports are busy, run `./scripts/stop.sh` first; then `./scripts/setup` and `./scripts/start.sh` |
  30. | <img src="https://cdn.jsdelivr.net/npm/simple-icons/icons/anthropic.svg" alt="Anthropic" width="16" height="16" /> **[Claude Code][claude-code-url]** | Docker: `PAI_DEFAULT_AGENT_ID=claude ./scripts/docker-start.sh`<br />Local: if ports are busy, run `./scripts/stop.sh` first; then `./scripts/setup --agent claude` and `PAI_DEFAULT_AGENT_ID=claude ./scripts/start.sh` |
  31. Either way, a project's agent can be changed at any time from the control in the terminal panel's header — the choice above only sets what a *new* project starts with.
  32. Open Docker at <http://localhost:7588> or local at <http://localhost:7443>.
  33. ## API Service
  34. `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](docs/api_service.md).
  35. | Capability | Quality | Time | # of references | Estimated price |
  36. |---|---|---|---|---|
  37. | [`generate_image`](server/cli/generate_image.js) | Great | ~10-30s | 16 imgs | $0.11 / $0.16 / $0.23 for 1K / 2K / 4K |
  38. | [`generate_image_pro`](server/cli/generate_image_pro.js) | Best | ~3-6 min | 32 imgs | $0.26 / $0.45 / $0.77 for 1K / 2K / 4K |
  39. | [`generate_video`](server/cli/generate_video.js) | Best | ~3-6 min | 9 imgs / 3 vids / 3 auds | $0.11/s / $0.23/s / $0.57/s for 480p / 720p / 1080p |
  40. | [`upscaler`](server/cli/upscaler.js) | Best | 1-min example: ~4-8 min landed | 1 video | 1-min example: $1.35 for 1080p->4K, $2.35 for 720p->4K |
  41. | [`generate_voice`](server/cli/generate_voice.js) | Good | ~5-15s | N/A | $0.01 per 500 input characters, rounded up |
  42. ## Resources
  43. - 💬 [Discord][discord-url] — questions, ideas, support, and show & tell
  44. - ⚙️ [API Service](docs/api_service.md) — developer platform notes, BYOK counterparts, and exact media JSON payloads
  45. - 🎬 [Skills reference](docs/skills.md) — how filmmaking skills route agent requests
  46. - 🚀 [Setup and agents](docs/setup.md) — choose Docker or host mode, configure Claude/Codex, and understand ports, auth, and permissions
  47. - 🏗 [Architecture](docs/architecture.md) — viewer, CLI, canvas, and project-file layout
  48. - ❓ [FAQ](docs/faq.md) — common setup and generation issues
  49. - 🐛 [Issues](https://github.com/Utopai-Research/pai-pro/issues) — bug reports only
  50. - 🤝 [Contributing](CONTRIBUTING.md) — contribution guide, proprietary-skills carve-out, and CLA flow
  51. ## License
  52. PAI-Pro is released under the [PAI PRO Sustainable Use License](LICENSE.md), 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](mailto:enterprise@utopaistudios.com) are available.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.