kinema-setup

Configure and verify the Kinema video production environment across six staged checkpoints.

131|10|Updated Aug 14, 2026
One-click install
npx skills add https://github.com/chillzhuang/Kinema --skill kinema-setup-chillzhuang
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: kinema-setup
Source: https://github.com/chillzhuang/Kinema/tree/main/.claude/skills/kinema-setup
Command: npx skills add https://github.com/chillzhuang/Kinema --skill kinema-setup-chillzhuang

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up the Kinema film-production pipeline involves many moving parts—ffmpeg, Python interpreters, optional pip extras, API keys, MySQL, object storage, and audio libraries—and a single misconfigured piece silently breaks downstream rendering. This Skill walks through every configuration decision, verifies each one with a re-runnable command, and diagnoses environment failures without ever performing content production. ## Core Features & Use Cases - Six-Node Guided Setup: Covers system dependencies (ffmpeg/ffprobe, Python 3.10+), engine pip extras, local vs MySQL storage, local vs OSS media backends, cloud API keys, and the CC0 BGM/SFX audio library—each node ends with a verification command. - Non-Interactive Diagnostics: Uses python3 -m kinema setup --check and doctor to report readiness without hanging on interactive prompts, plus a troubleshooting table mapping symptoms (missing PyYAML, sine-wave BGM, orphan ffmpeg processes) to fixes. - Strict Safety Discipline: Never installs system packages or database servers itself, never echoes secret values, and prefers environment variables over editing committed config files. - Use Case: A user clones the Kinema repository on a new machine and asks the agent to get it ready; the Skill detects the platform, gives exact install commands for the user to run, verifies each stage, and finishes with a mock end-to-end render plus a readiness summary table. ## Quick Start Ask the agent to check and configure my Kinema environment so it can pass setup --check and run a mock render.

Frequently Asked Questions about kinema-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up the Kinema environment on a new machine?▼

Run the guided six-node setup: verify Python 3.10+ and ffmpeg/ffprobe, install the engine with pip install -e ".[cloud,yaml]" from the engine directory, choose storage backends, set API keys, download the audio library, then confirm with python3 -m kinema setup --check and a mock render.

How do I check if my Kinema installation is ready?▼

Run python3 -m kinema setup --check for a non-interactive readiness report that exits non-zero listing unready items, and python3 -m kinema doctor for a full health report covering ffmpeg version, storage backend, providers, and music library count.

Why does Kinema warn about missing PyYAML and fall back to default config?▼

The Python interpreter actually running the engine lacks the yaml extra, so config files are silently ignored in favor of built-in defaults. Fix it by running pip install -e ".[yaml]" with that exact interpreter, since multiple Python versions on one machine each need their own extras.

Does Kinema setup install MySQL or object storage for me?▼

No. The Skill never installs, starts, or modifies MySQL servers or OSS buckets—you provide your own database and bucket, and it only installs client drivers like PyMySQL, collects connection details, and verifies connectivity with db status and oss status.

Why is my Kinema BGM just a sine-wave hum?▼

The local music library is empty and no ElevenLabs API key is configured, so the engine falls back to a synthesized tone bed. Run python music/download.py to fetch 103 CC0 BGM tracks and 18 sound effects, then verify with doctor.

Can Kinema setup run the interactive setup command in an agent session?▼

No. The interactive setup command waits on stdin and will hang an agent session, so all self-checks must use python3 -m kinema setup --check and doctor, which are non-interactive and safe to run.