Summary

This project provides an AI agent skill (SKILL.md) enabling various AI platforms (OpenClaw, Windsurf, etc.) to automate movie narration video creation via the narrator-ai-cli tool. It allows users to generate videos using natural language commands, streamlining the production process from script to final composition.

How It Works

The SKILL.md file acts as a "recipe book" for AI agents, translating natural language requests into executable commands for the narrator-ai-cli tool. The AI orchestrates a full video production pipeline, including movie searching, template selection, BGM and voice picking, script generation, video composition, and final download link delivery. This decouples the AI's "brain" (skill) from the "hands" (CLI tool).

Quick Start & Requirements

1. Install CLI: pip install "narrator-ai-cli @ git+https://github.com/jieshuo-ai/narrator-ai-cli.git"
2. Configure API Key: Run narrator-ai-cli config set app_key <your_app_key>. Obtain keys by emailing merlinyang@gridltd.com.
3. Install Skill: Copy SKILL.md to your agent's skill directory (e.g., ~/.openclaw/skills/narrator-ai-cli/SKILL.md). Many agents can auto-configure by pointing to the repository URL.
   • Prerequisites: Python 3.10+, narrator-ai-cli v0.1.0+, and dependencies (typer, httpx[socks], httpx-sse, pyyaml, rich). An API key is mandatory.
   • Links: CLI repo: https://github.com/jieshuo-ai/narrator-ai-cli.git

Highlighted Details

• Supports two distinct workflow paths: Adapted Narration and Original Narration.
• Offers three creation modes: Hot Drama, Original Mix, and New Drama.
• Provides extensive built-in resources: 93 movies, 146 BGM tracks, 63 dubbing voices, and over 90 narration templates.
• Includes standalone capabilities for voice cloning and text-to-speech.
• Features comprehensive error handling for all 18 API error codes and budget verification before task initiation.

Maintenance & Community

Direct contact for API keys and support is available via email (merlinyang@gridltd.com). The README does not detail specific community channels (like Discord/Slack) or notable contributors.

Licensing & Compatibility

The project is released under the MIT license, which permits broad usage, including commercial applications and linking within closed-source projects.

Limitations & Caveats

Operation is contingent on obtaining a proprietary API key via email. The narrator-ai-cli tool itself is at version 0.1.0, suggesting potential early-stage development or ongoing changes.