nemovideo-tools 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NemoVideo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, LIABILITY, OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,120 @@
+# NemoVideo Tools
+
+AI video creation and editing from the command line. Describe what you want, AI creates it.
+
+> Create videos by chatting — no GUI needed. Works with Claude Code, Codex, OpenClaw, Cursor, and any AI IDE.
+
+## Quick Start
+
+```bash
+npm install -g nemovideo-tools
+nemovideo setup
+nemovideo create --prompt "5-second coffee product showcase" --export
+```
+
+## What It Does
+
+- **Text to Video** — describe a scene, get a video
+- **AI Editing** — add BGM, titles, transitions by chatting
+- **Export** — render and download MP4
+- **Upload** — bring your own footage
+
+## Prerequisites
+
+- Node.js >= 18
+- NemoVideo account with API key ([nemovideo.com](https://nemovideo.com))
+
+## Install
+
+```bash
+# Global install
+npm install -g nemovideo-tools
+
+# Or run without install
+npx nemovideo-tools create --prompt "..."
+
+# Claude Code plugin install
+claude install-plugin nemovideo/nemovideo-tools
+```
+
+## Setup
+
+```bash
+nemovideo setup
+```
+
+This guides you through:
+1. Register at nemovideo.com
+2. Generate API key at nemovideo.com workspace → API Keys
+3. Paste key into CLI
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `nemovideo create -p "..."` | Create a new video |
+| `nemovideo chat <id> -p "..."` | Edit an existing project |
+| `nemovideo export <id>` | Render and download |
+| `nemovideo upload <file> --project <id>` | Upload assets |
+| `nemovideo open <id>` | Open in browser |
+| `nemovideo project list` | List projects |
+| `nemovideo project get <id>` | Project details |
+| `nemovideo project download <id>` | Download video |
+| `nemovideo credits` | Check balance |
+| `nemovideo setup` | Configure API key |
+| `nemovideo config set/get` | Manage settings |
+
+## Examples
+
+```bash
+# Create and auto-export
+nemovideo create -p "10s tech product demo, modern style" -d 10 --export
+
+# Create, edit, then export
+nemovideo create -p "coffee product showcase"
+nemovideo chat proj_abc -p "add lo-fi background music"
+nemovideo chat proj_abc -p "add title 'Morning Brew' at the beginning"
+nemovideo export proj_abc -o ./coffee-video.mp4
+
+# Upload your own footage
+nemovideo upload ./raw-footage.mp4 --project proj_abc
+nemovideo chat proj_abc -p "trim to first 5 seconds and add subtitles"
+```
+
+## Configuration
+
+Config stored at `~/.config/nemovideo/config.json`.
+
+```bash
+nemovideo config set api_key nmv_usr_xxx     # API token
+nemovideo config set base_url https://...     # Gateway URL
+nemovideo config set output_dir ./output      # Default output directory
+nemovideo config get                          # Show all config
+```
+
+Environment variable `NEMOVIDEO_API_KEY` overrides the stored api_key:
+```bash
+export NEMOVIDEO_API_KEY=nmv_usr_xxx
+nemovideo credits
+```
+
+## For AI IDE Users
+
+This package comes with a `SKILL.md` that teaches AI agents (Cursor, Claude Code, etc.) how to use it. Install the package, and your AI assistant can create videos for you.
+
+## Supported Formats
+
+| Type | Formats |
+|------|---------|
+| Video | mp4, mov, avi, webm, mkv |
+| Image | jpg, png, gif, webp |
+| Audio | mp3, wav, m4a, aac |
+
+## Links
+
+- [NemoVideo](https://nemovideo.com) — Product website
+- [Documentation](https://docs.nemovideo.com) — Full docs
+
+## License
+
+MIT

package/SKILL.md

@@ -0,0 +1,150 @@
+---
+name: nemo-video
+version: "0.1.0"
+description: >
+  AI video creation and editing via CLI. Create videos from text descriptions,
+  edit with background music, titles, transitions, and export MP4 files.
+  Requires API key from nemovideo.com (paid).
+  Supports mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.
+homepage: https://nemovideo.com
+repository: https://github.com/nemovideo/nemovideo-tools
+metadata: {"openclaw": {"emoji": "🎬", "requires": {"env": [], "configPaths": ["~/.config/nemovideo/"]}, "primaryEnv": "NEMO_API_KEY"}}
+---
+
+# NemoVideo Tools — AI Video Creation
+
+Create and edit videos by running `nemovideo` commands. No GUI needed.
+
+## Prerequisites
+
+Requires Node.js >= 18 and a paid NemoVideo account.
+
+```bash
+npm install -g nemovideo-tools
+nemovideo setup
+```
+
+`nemovideo setup` guides you through: register → billing → API key configuration.
+If already configured, verify with `nemovideo credits`.
+
+## Commands
+
+### Create Video
+
+```bash
+nemovideo create --prompt "5-second coffee product showcase, warm tones"
+nemovideo create --prompt "10s tech demo" --duration 10 --ratio 16:9
+nemovideo create --prompt "short intro" --export              # create + auto export
+nemovideo create --prompt "short intro" --export -o ./out.mp4 # with custom output path
+```
+
+| Flag | Short | Default | Description |
+|------|-------|---------|-------------|
+| `--prompt` | `-p` | (required) | Video description |
+| `--duration` | `-d` | 5 | Duration in seconds |
+| `--ratio` | `-r` | 16:9 | Aspect ratio: 16:9, 9:16, 1:1 |
+| `--export` | `-e` | off | Auto export after creation |
+| `--output` | `-o` | ./output/<name>.mp4 | Output path (with --export) |
+
+Returns `project_id` for subsequent commands.
+
+### Edit Existing Project
+
+```bash
+nemovideo chat <project_id> --prompt "add background music"
+nemovideo chat <project_id> --prompt "change duration to 10 seconds"
+nemovideo chat <project_id> --prompt "add title 'Hello World' at the beginning"
+```
+
+### Export Video
+
+```bash
+nemovideo export <project_id>
+nemovideo export <project_id> --output ./my-video.mp4
+```
+
+Export is free — only creation/editing consumes credits.
+
+### Upload Assets
+
+```bash
+nemovideo upload ./footage.mp4 --project <project_id>
+nemovideo upload ./music.mp3 --project <project_id>
+nemovideo upload ./logo.png --project <project_id>
+```
+
+Supported: mp4, mov, avi, webm, mkv, jpg, png, gif, webp, mp3, wav, m4a, aac.
+
+### Open in Browser
+
+```bash
+nemovideo open <project_id>
+```
+
+### Project Management
+
+```bash
+nemovideo project list
+nemovideo project get <project_id>
+nemovideo project download <project_id> --output ./video.mp4
+```
+
+### Credits
+
+```bash
+nemovideo credits                   # check balance
+nemovideo credits history           # consumption history
+```
+
+## Typical Workflow
+
+```bash
+# 1. Create a video
+nemovideo create -p "product showcase video, 10 seconds, modern style" -d 10
+
+# 2. Edit it
+nemovideo chat <project_id> -p "add upbeat background music"
+nemovideo chat <project_id> -p "add title 'Our Product' at the beginning"
+
+# 3. Export
+nemovideo export <project_id> -o ./product-video.mp4
+
+# 4. Or do it all in one step
+nemovideo create -p "product showcase" --export -o ./product-video.mp4
+```
+
+## One-Step Workflow (for simple requests)
+
+```bash
+nemovideo create --prompt "5-second sunset timelapse" --export
+```
+
+## Error Handling
+
+| Error | What to do |
+|-------|------------|
+| "API key not configured" | Run `nemovideo setup` |
+| "Token expired" | Run `nemovideo setup` to reconfigure |
+| "Insufficient credits" | Top up at nemovideo.com/dashboard/billing |
+| "Rate limited" | Wait a moment and retry |
+| Connection dropped | Run `nemovideo project get <id>` to check status |
+
+## Configuration
+
+```bash
+nemovideo config set api_key <nmv_usr_xxx>
+nemovideo config set base_url https://mega-x-api-prod.nemovideo.ai
+nemovideo config set output_dir ./output
+nemovideo config get
+```
+
+Config stored at `~/.config/nemovideo/config.json`.
+
+Environment variable `NEMOVIDEO_API_KEY` overrides the stored api_key.
+
+## Cost Reference
+
+- Video creation: ~100 credits/clip
+- Video editing: ~50 credits/session
+- Export/render: free
+- Check balance: `nemovideo credits`