Skip to content
Back to search

narrator-ai-cli

AI 解说大师 — CLI 客户端;用于终端调用视频解说生成 API

Safety scan

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

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/NarratorAI-Studio/narrator-ai-cli with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/NarratorAI-Studio/narrator-ai-cli'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/narratorai-studio--narrator-ai-cli/badge.svg)](/listings/narratorai-studio--narrator-ai-cli)

HTML

<a href="/listings/narratorai-studio--narrator-ai-cli"><img src="/api/listings/narratorai-studio--narrator-ai-cli/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.

Step 1: Install the CLI

Prerequisites: [Python 3.10+](https://www.python.org/downloads/) (check "Add to PATH"), [Git](https://git-scm.com/downloads)

**macOS / Linux**

curl -fsSL https://raw.githubusercontent.com/NarratorAI-Studio/narrator-ai-cli/main/install.py | python3

**Windows (CMD / PowerShell)**

python -c "import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/NarratorAI-Studio/narrator-ai-cli/main/install.py').read())"

Verify:

narrator-ai-cli --version

Step 2: Get an API Key

> 📧 Email **merlinyang@gridltd.com** or scan the QR code below to get your API key.

Step 3: Configure

narrator-ai-cli config set app_key your_api_key

Step 4: Start creating videos!

If using with an AI agent (OpenClaw, etc.), just use natural language:

> "Create a narration video for The Shawshank Redemption with an inspirational style"

For terminal usage, see Command Reference below.

---

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.

README.md · README · 266 lines · 1 finding marked

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

  1. # 🎬 Narrator AI CLI — Create Movie Narration Videos with Natural Language
  2. [中文文档](README_CN.md)
  3. > One command to install, one sentence to create videos. 93 built-in movies, 146 BGM tracks, 63 dubbing voices, 90+ narration templates — ready out of the box.
  4. ## What is this?
  5. Narrator AI CLI is the command-line tool for [Narrator AI](https://ai.jieshuo.cn/), an AI-powered video narration platform. Once installed in your AI agent (OpenClaw, Windsurf, WorkBuddy, etc.), just say:
  6. > "Create a movie narration video for Pegasus in a comedy style"
  7. The AI handles everything automatically:
  8. ```
  9. Select movie → Match narration style → Generate script → Compose video → Output download link
  10. ```
  11. **No manual steps required. The AI completes the entire pipeline for you.**
  12. ### What it can do
  13. - ✅ **Movie narration videos**: Input a movie name, get a complete narration video (script + voiceover + footage + BGM)
  14. - ✅ **Multiple narration styles**: Action, Comedy, Thriller and more — 12 genres, 90+ templates
  15. - ✅ **Multi-language voiceover**: 11 languages including English, Mandarin, Japanese, and 63 voice characters
  16. - ✅ **Batch production**: Tell the AI "make 10 narration videos" and it will process them one by one
  17. - ✅ **Run unattended**: Let the agent work while you sleep
  18. ---
  19. ## Quick Start
  20. ### Step 1: Install the CLI
  21. Prerequisites: [Python 3.10+](https://www.python.org/downloads/) (check "Add to PATH"), [Git](https://git-scm.com/downloads)
  22. **macOS / Linux**
  23. ```bash
  24. curl -fsSL https://raw.githubusercontent.com/NarratorAI-Studio/narrator-ai-cli/main/install.py | python3
  25. ```
  26. **Windows (CMD / PowerShell)**
  27. ```bat
  28. python -c "import urllib.request; exec(urllib.request.urlopen('https://raw.githubusercontent.com/NarratorAI-Studio/narrator-ai-cli/main/install.py').read())"
  29. ```
  30. Verify:
  31. ```bash
  32. narrator-ai-cli --version
  33. ```
  34. ### Step 2: Get an API Key
  35. > 📧 Email **merlinyang@gridltd.com** or scan the QR code below to get your API key.
  36. ![Contact us](./imgs/contact.png)
  37. ### Step 3: Configure
  38. ```bash
  39. narrator-ai-cli config set app_key your_api_key
  40. ```
  41. ### Step 4: Start creating videos!
  42. If using with an AI agent (OpenClaw, etc.), just use natural language:
  43. > "Create a narration video for The Shawshank Redemption with an inspirational style"
  44. For terminal usage, see Command Reference below.
  45. ---
  46. ## Using with AI Agents (Recommended)
  47. This tool works best with AI agents. Install the Skill so the agent knows how to use these commands.
  48. 👉 **Install the Skill**: [narrator-ai-cli-skill](https://github.com/NarratorAI-Studio/narrator-ai-cli-skill)
  49. ### Tested Platforms
  50. | Platform | Setup | Experience |
  51. |----------|-------|------------|
  52. | **Windsurf** | CLI repo only | ⭐⭐⭐⭐⭐ Auto-understands |
  53. | **WorkBuddy** (Tencent) | CLI + Skill repos | ⭐⭐⭐⭐⭐ Smooth |
  54. | **Youdao Lobster** | CLI + Skill repos | ⭐⭐⭐⭐ Reliable |
  55. | **QClaw** (Tencent) | CLI + Skill repos | ⭐⭐⭐⭐ Reliable |
  56. | **Yuanqi AI** | CLI + Skill repos | ⭐⭐⭐ Functional |
  57. > 💡 **Note**: Most domestic Chinese AI agents require both CLI and Skill repo URLs. Windsurf can work with just the CLI repo.
  58. ---
  59. ## Built-in Resources
  60. No uploads needed — all of these are ready to use:
  61. | Resource | Count | Command |
  62. |----------|-------|---------|
  63. | 🎬 Movie materials | 93 movies | `narrator-ai-cli material list` |
  64. | 🎵 Background music | 146 tracks | `narrator-ai-cli bgm list` |
  65. | 🎙️ Dubbing voices | 63 voices (11 languages) | `narrator-ai-cli dubbing list` |
  66. | 📝 Narration templates | 90+ (12 genres) | `narrator-ai-cli task narration-styles` |
  67. > 🔗 Preview all resources: [Feishu Docs](https://ceex7z9m67.feishu.cn/wiki/WLPnwBysairenFkZDbicZOfKnbc)
  68. ---
  69. ## Two Workflow Paths
  70. ### Original Narration (Recommended — faster & cheaper)
  71. ```
  72. Search movie → Fast writing → Fast clip data → Video composing → Magic video (optional)
  73. ```
  74. 3 modes:
  75. - **Hot Drama**: Well-known movies with full info available
  76. - **Original Mix**: Mix original audio with narration
  77. - **New Drama**: Short dramas or movies without full info
  78. ### Adapted Narration
  79. ```
  80. Popular learning → Generate writing → Clip data → Video composing → Magic video (optional)
  81. ```
  82. ---
  83. ## Command Reference
  84. ### Config
  85. | Command | Description |
  86. |---------|-------------|
  87. | `config init` | Interactive setup (server URL + API key) |
  88. | `config show` | Show current config (key masked) |
  89. | `config set <key> <value>` | Set a config value |
  90. ### User
  91. | Command | Description |
  92. |---------|-------------|
  93. | `user balance` | Query account balance |
  94. | `user login` | Login with username/password |
  95. | `user keys` | List sub API keys |
  96. | `user create-key` | Create a sub API key |
  97. ### Task
  98. | Command | Description |
  99. |---------|-------------|
  100. | `task types` | List task types (`-V` for details) |
  101. | `task create <type> -d '{...}'` | Create a task |
  102. | `task query <task_id>` | Query task status and results |
  103. | `task list` | List tasks with filters |
  104. | `task budget -d '{...}'` | Estimate credits consumption |
  105. | `task verify -d '{...}'` | Verify materials before creation |
  106. | `task search-movie "<name>"` | Search movie info |
  107. | `task narration-styles` | List narration templates (90+) |
  108. | `task templates` | List visual templates for magic-video |
  109. | `task get-writing` | Retrieve generated script |
  110. | `task save-writing -d '{...}'` | Save modified script |
  111. | `task save-clip -d '{...}'` | Save modified clip data |
  112. **Task Types:**
  113. | Type | Workflow Position |
  114. |------|-------------------|
  115. | `popular-learning` | Adapted Narration Step 1 |
  116. | `generate-writing` | Adapted Narration Step 2 |
  117. | `fast-writing` | Original Narration Step 1 |
  118. | `clip-data` | Adapted Narration Step 3 |
  119. | `fast-clip-data` | Original Narration Step 2 |
  120. | `video-composing` | Video composing (both paths) |
  121. | `magic-video` | Optional final step (visual template) |
  122. | `voice-clone` | Standalone |
  123. | `tts` | Standalone |
  124. ### File
  125. | Command | Description |
  126. |---------|-------------|
  127. | `file upload <path>` | Upload file (returns file_id) |
  128. | `file transfer --link <url>` | Transfer remote file by link (HTTP / Baidu Netdisk / PikPak) |
  129. | `file list` | List uploaded files |
  130. | `file info <file_id>` | Get file details |
  131. | `file download <file_id>` | Get presigned download URL |
  132. | `file storage` | Show storage usage (3GB limit) |
  133. | `file delete <file_id>` | Delete a file |
  134. ### Materials / BGM / Dubbing
  135. | Command | Description |
  136. |---------|-------------|
  137. | `material list` | List 93 pre-built movies (`--genre`, `--search`) |
  138. | `material genres` | List movie genres with counts |
  139. | `bgm list` | List 146 BGM tracks (`--search`) |
  140. | `dubbing list` | List 63 voices (`--lang`, `--tag`, `--search`) |
  141. | `dubbing languages` | List supported languages |
  142. | `dubbing tags` | List genre recommendation tags |
  143. ## Data Flow
  144. ```
  145. file upload / file list / material list
  146. -> video_file_id, srt_file_id
  147. bgm list -> bgm_id
  148. dubbing list -> dubbing, dubbing_type
  149. Adapted Narration Original Narration (faster)
  150. ───────────────── ────────────────────────────
  151. popular-learning (optional) search-movie
  152. OUT: learning_model_id OUT: confirmed_movie_json
  153. OR use pre-built template │
  154. │ fast-writing (3 modes)
  155. ▼ IN: learning_model_id + movie_json
  156. generate-writing OUT: task_id, file_ids[0]
  157. IN: learning_model_id, episodes │
  158. OUT: task_order_num, file_ids[0] fast-clip-data
  159. │ IN: task_id, file_id, episodes
  160. ▼ OUT: task_order_num
  161. clip-data │
  162. IN: order_num, bgm, dubbing │
  163. OUT: file_ids[0] │
  164. │ │
  165. ▼ ▼
  166. video-composing
  167. IN: order_num (from writing step), bgm, dubbing
  168. OUT: task_id, video URLs
  169. │
  170. ▼
  171. magic-video (optional)
  172. IN: task_id or file_id + template_name
  173. OUT: rendered video URLs
  174. ```
  175. ## JSON Output
  176. All commands support `--json` for structured output (recommended for AI agents):
  177. ```bash
  178. narrator-ai-cli task list --json
  179. narrator-ai-cli task query <task_id> --json
  180. ```
  181. ## Environment Variables
  182. | Variable | Description |
  183. |----------|-------------|
  184. | `NARRATOR_SERVER` | API server URL |
  185. | `NARRATOR_APP_KEY` | API key |
  186. | `NARRATOR_TIMEOUT` | Timeout in seconds (default: 30) |
  187. ## AI Agent Integration
  188. See [narrator-ai-cli-skill](https://github.com/NarratorAI-Studio/narrator-ai-cli-skill) for the complete SKILL.md that teaches AI agents how to use this tool automatically.
  189. ## Contact
  190. Need an API key or help? Reach out:
  191. - 📧 Email: merlinyang@gridltd.com
  192. - 💬 WeChat: Scan the QR code below
  193. ![Contact us](./imgs/contact.png)

Ratings and comments

Sign in to rate this skill.

Sign in

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