@cliptude/cli 0.1.5 → 0.1.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +44 -8
- package/cliptude_mcp/__pycache__/__init__.cpython-313.pyc +0 -0
- package/cliptude_mcp/__pycache__/__init__.cpython-314.pyc +0 -0
- package/cliptude_mcp/__pycache__/__main__.cpython-313.pyc +0 -0
- package/cliptude_mcp/__pycache__/auth.cpython-313.pyc +0 -0
- package/cliptude_mcp/__pycache__/auth.cpython-314.pyc +0 -0
- package/cliptude_mcp/__pycache__/auth_login.cpython-313.pyc +0 -0
- package/cliptude_mcp/__pycache__/auth_login.cpython-314.pyc +0 -0
- package/cliptude_mcp/__pycache__/cli.cpython-313.pyc +0 -0
- package/cliptude_mcp/__pycache__/cli.cpython-314.pyc +0 -0
- package/cliptude_mcp/__pycache__/client.cpython-313.pyc +0 -0
- package/cliptude_mcp/__pycache__/client.cpython-314.pyc +0 -0
- package/cliptude_mcp/__pycache__/credentials.cpython-313.pyc +0 -0
- package/cliptude_mcp/__pycache__/credentials.cpython-314.pyc +0 -0
- package/cliptude_mcp/__pycache__/server.cpython-313.pyc +0 -0
- package/cliptude_mcp/__pycache__/server.cpython-314.pyc +0 -0
- package/cliptude_mcp/cli.py +523 -23
- package/cliptude_mcp/client.py +657 -77
- package/cliptude_mcp/server.py +644 -42
- package/package.json +1 -1
- package/pyproject.toml +1 -1
package/README.md
CHANGED
|
@@ -6,7 +6,7 @@ Generate videos from a saved template. Same account and credits as cliptude.com.
|
|
|
6
6
|
|
|
7
7
|
1. Install the CLI: run `npm i -g @cliptude/cli`.
|
|
8
8
|
2. Authenticate: run `cliptude auth login` and complete the sign-in in the browser it opens.
|
|
9
|
-
3. Install the companion skills: run `npx skills add cliptude/cliptude
|
|
9
|
+
3. Install the companion skills: run `npx skills add cliptude/cliptude`.
|
|
10
10
|
|
|
11
11
|
From this repo without npm:
|
|
12
12
|
|
|
@@ -19,21 +19,57 @@ cliptude auth login
|
|
|
19
19
|
|
|
20
20
|
```bash
|
|
21
21
|
cliptude templates
|
|
22
|
+
cliptude template-options --format faceless_documentary
|
|
23
|
+
cliptude voices --provider elevenlabs
|
|
24
|
+
cliptude template-create --name "TSMC doc" --format faceless_documentary --set voice_id=<id> --set voice_name=George --set generation_model=pro --set faceless_documentary_style=investigative
|
|
25
|
+
cliptude template-create --name "TSMC doc" --format faceless_documentary --settings-file settings.json
|
|
22
26
|
cliptude generate --template "Finance vector weekly" --title "Why index funds win" --prompt "why most retail traders underperform the S&P over 10 years, keep it for beginners" --duration 3-4
|
|
27
|
+
cliptude estimate --template "Finance vector weekly" --script-file script.txt
|
|
28
|
+
cliptude avatars --section mine
|
|
29
|
+
cliptude generate --template "My avatar weekly" --title "Episode one" --script-file script.txt --avatar 42
|
|
23
30
|
cliptude generate --template "Finance vector weekly" --title "Why index funds win" --script-file script.txt
|
|
24
31
|
cliptude generate --template "Finance vector weekly" --title "Why index funds win" --voiceover narration.mp3
|
|
32
|
+
cliptude generate --template "My talking head" --title "Weekly recap" --talking-head clip.mp4
|
|
33
|
+
cliptude generate --template "My avatar weekly" --title "Grandma egg trick" --script-file script.txt --avatar-ai-footage --avatar-intro-only
|
|
34
|
+
cliptude script --template "Finance vector weekly" --title "Why index funds win" --prompt "why most retail traders underperform the S&P" --duration 3-4
|
|
35
|
+
cliptude voiceover --template "Finance vector weekly" --title "Why index funds win" --script-file script.txt
|
|
36
|
+
cliptude download-voiceover <job-id> --out narration.mp3
|
|
37
|
+
cliptude editor <job-id> # editor project id, revision, timeline item ids
|
|
38
|
+
cliptude agent <project-id> --prompt "Replace this shot with real footage of a TSMC fab" --items clip-1 --tier smart --wait
|
|
39
|
+
cliptude render <project-id> --wait # new MP4 of the edited timeline
|
|
40
|
+
cliptude continue <job-id>
|
|
25
41
|
cliptude status <job-id>
|
|
26
42
|
```
|
|
27
43
|
|
|
28
|
-
|
|
44
|
+
No template yet? `template-create` makes one without the create wizard: pick a `voice_id` from `voices`, and see `template-options` for every other field, its choices and its default (unset fields take the wizard default). Values are validated like the wizard; uploads (custom music, avatars, characters) still need the wizard. MCP tools: `get_template_options`, `list_voices`, `create_template`. For Avatar Video, `avatars` (MCP `list_avatars`) lists your avatars; set one with `--set avatar_profile_id=<id>` on `template-create`, or override it per video with `--avatar <id>` (and `--avatar-engine iii|iv|v`) on `generate`, `plan-job` and `estimate`. The avatar's gender must match the voice. For Vector Explainer, `vector-characters` lists the built-in cast and your uploads, `vector-character-upload --name "Dr. Maya" --file maya.png` (or `--url`) adds your own, and `--set vector_character_id=<id>` on `template-create` (or `--vector-character <id>` on `generate` / `plan-job`) uses it. Motion: `--set vector_reveal_mode=none|video` on the template, or `--vector-motion none|video` on `generate`, `plan-job` and `estimate` (`none` = stills with camera moves, `video` = AI clips). Thumbnails: `--thumbnail-reference <YouTube link or image URL>` or `--thumbnail-prompt "<brief>"` on `template-create` sets the template's look; the same flags on `generate` and `plan-job` set one video's. With neither, each video picks a style reference for its own title.
|
|
29
45
|
|
|
30
|
-
|
|
46
|
+
To check the price first, `estimate` (MCP `estimate_credits`, REST `POST /api/v1/jobs/estimate`) takes the same template and prompt/script as `generate` (an upload as `--voiceover-seconds` / `--talking-head-seconds`) and returns the credits the job would need and whether the account has them. It creates and charges nothing.
|
|
31
47
|
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
48
|
+
To revise a finished video, `editor` opens its timeline (item ids, times, text), `agent` asks Cliptude Agent for an edit (it charges agent credits; reference item ids with `--items`), and `render` exports a new MP4. MCP tools: `open_editor_project`, `get_editor_project`, `run_agent`, `get_agent_run`, `cancel_agent_run`, `render_project`, `get_render`.
|
|
49
|
+
|
|
50
|
+
### Agent-planned videos
|
|
51
|
+
|
|
52
|
+
On Faceless Documentary, Faceless Top 10, Avatar Video and Vector Explainer templates an agent can plan every visual and leave Cliptude
|
|
53
|
+
only the voicing, sourcing and rendering:
|
|
54
|
+
|
|
55
|
+
1. `cliptude plan-job` (stops at `plan_ready`), `cliptude narration <job>`.
|
|
56
|
+
2. `cliptude catalog --compact`, then `--types a,b` for full entries (`--premium` lists only the premium boards).
|
|
57
|
+
3. `cliptude plan-check <job> plan.json` until valid, `cliptude plan-lock <job> plan.json`, `cliptude continue <job>`.
|
|
58
|
+
The job stops at `ready_for_edit`: built and charged, not rendered.
|
|
59
|
+
4. `cliptude plan-review <job>`: every picture or clip (asked vs used, link to the file) and every graphic (the props
|
|
60
|
+
it will be drawn with, or why it is missing). `cliptude plan-report <job>` adds each fallback.
|
|
61
|
+
5. To revise, `plan-check` / `plan-lock` a new plan on the same job and `continue` again: same narration, unchanged
|
|
62
|
+
media reused, nothing more charged.
|
|
63
|
+
6. Render once: `cliptude editor <job>`, `cliptude render <project> --wait`.
|
|
64
|
+
|
|
65
|
+
MCP tools: `create_plan_job`, `get_narration`, `get_kind_catalog`, `check_plan`, `lock_plan`, `get_plan`,
|
|
66
|
+
`continue_job`, `get_plan_review`, `get_plan_report`, then `open_editor_project` and `render_project`.
|
|
67
|
+
The plan sets the look (theme, style, colours, music), every graphic with its own data, colours and sound, the
|
|
68
|
+
footage under every beat, the transition on each cut, two-image reveals, and free sound effects; `get_kind_catalog`
|
|
69
|
+
lists the graphics, `transitions`, `reveal_styles` and `sounds` (with previews). The plan schema and rules are in
|
|
70
|
+
`skills/cliptude-plan/SKILL.md`. The job costs the same as the website price.
|
|
71
|
+
|
|
72
|
+
`--title` is required. Provide **one** of `--prompt`, `--script` / `--script-file`, `--voiceover`, or `--talking-head`. Never copy the title into `--prompt`. If you only have a topic, follow **cliptude-script** (web search → spoken narration → `--script-file`), or ask Cliptude to write it with `cliptude script`. After a completed `script` or `voiceover` job, `cliptude continue <job-id>` turns that same job into a full video (reuses the script; voiceover jobs reuse the TTS file). `--voiceover` is a local audio file (same as create.html); it is transcribed and skips TTS — do not combine it with prompt/script. `--talking-head` is a presenter video on a Talking Head template (MP4, MOV, WEBM, AVI); it is transcribed and skips TTS. Optional `--duration` is a wizard bucket (`3-4`, `6-8`, `10-12`, …). Omit it to use the template duration, or the word-count estimate when you pass `--script`. Uploaded audio or talking-head video sets duration from the file. Avatar Video templates can override **Avatar Intro Only** and **AI Image + AI Video** with `--avatar-intro-only` / `--no-avatar-intro-only` and `--avatar-ai-footage` / `--no-avatar-ai-footage`. Omit those flags to keep the template. `generate` / `script` / `voiceover` / `continue` return immediately (`queued`). Poll `status`.
|
|
37
73
|
|
|
38
74
|
## MCP
|
|
39
75
|
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|
|
Binary file
|