{"id":51194836,"url":"https://github.com/davidmosiah/short-video-agent-kit","last_synced_at":"2026-06-27T19:02:48.041Z","repository":{"id":355832866,"uuid":"1229801169","full_name":"davidmosiah/short-video-agent-kit","owner":"davidmosiah","description":"Agent-first short-form AI video generation CLI and MCP server for Sora, Veo, xAI and Seedance","archived":false,"fork":false,"pushed_at":"2026-05-23T18:20:49.000Z","size":160,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-23T20:15:20.597Z","etag":null,"topics":["agent-tools","agentic-workflows","ai-agents","claude","codex","creator-tools","dry-run","gemini","local-first","mcp","mcp-server","model-context-protocol","sora","veo","video-generation","video-tools","xai"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/short-video-agent-kit","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/davidmosiah.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-05T11:54:14.000Z","updated_at":"2026-05-23T18:20:53.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/davidmosiah/short-video-agent-kit","commit_stats":null,"previous_names":["davidmosiah/short-video-agent-kit"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/davidmosiah/short-video-agent-kit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidmosiah%2Fshort-video-agent-kit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidmosiah%2Fshort-video-agent-kit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidmosiah%2Fshort-video-agent-kit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidmosiah%2Fshort-video-agent-kit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/davidmosiah","download_url":"https://codeload.github.com/davidmosiah/short-video-agent-kit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/davidmosiah%2Fshort-video-agent-kit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34864431,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-27T02:00:06.362Z","response_time":126,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-tools","agentic-workflows","ai-agents","claude","codex","creator-tools","dry-run","gemini","local-first","mcp","mcp-server","model-context-protocol","sora","veo","video-generation","video-tools","xai"],"created_at":"2026-06-27T19:02:47.377Z","updated_at":"2026-06-27T19:02:48.033Z","avatar_url":"https://github.com/davidmosiah.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- delx header v2 --\u003e\n\u003ch1 align=\"center\"\u003eShort Video Agent Kit\u003c/h1\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"assets/banner.png\" alt=\"Short Video Agent Kit\" width=\"85%\" /\u003e\n\u003c/div\u003e\n\n\u003ch3 align=\"center\"\u003e\n  One agent-first CLI + MCP for short-form AI video.\u003cbr\u003eSora · Veo · xAI · Seedance \u0026mdash; dry-run by default, paid generation when explicitly enabled.\n\u003c/h3\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://www.npmjs.com/package/short-video-agent-kit\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/short-video-agent-kit?style=for-the-badge\u0026labelColor=0F172A\u0026color=10B981\u0026logo=npm\u0026logoColor=white\" alt=\"npm version\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/short-video-agent-kit\"\u003e\u003cimg src=\"https://img.shields.io/npm/dm/short-video-agent-kit?style=for-the-badge\u0026labelColor=0F172A\u0026color=0EA5A3\u0026logo=npm\u0026logoColor=white\" alt=\"npm downloads\" /\u003e\u003c/a\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/LICENSE-MIT-22C55E?style=for-the-badge\u0026labelColor=0F172A\" alt=\"License MIT\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://modelcontextprotocol.io\"\u003e\u003cimg src=\"https://img.shields.io/badge/BUILT_FOR-MCP-7C3AED?style=for-the-badge\u0026labelColor=0F172A\" alt=\"Built for MCP\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/davidmosiah/short-video-agent-kit/stargazers\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/davidmosiah/short-video-agent-kit?style=for-the-badge\u0026labelColor=0F172A\u0026color=FBBF24\u0026logo=github\" alt=\"GitHub stars\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/davidmosiah/short-video-agent-kit/actions/workflows/ci.yml\"\u003e\u003cimg src=\"https://github.com/davidmosiah/short-video-agent-kit/actions/workflows/ci.yml/badge.svg\" alt=\"CI status\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/davidmosiah\"\u003e\u003cimg src=\"https://img.shields.io/badge/PART_OF-Delx_Agent_Stack-0EA5A3?style=for-the-badge\u0026labelColor=0F172A\" alt=\"Part of the Delx agent stack\" /\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/davidmosiah/short-video-agent-kit\"\u003e\u003cimg src=\"https://img.shields.io/badge/CATEGORY-Reach-7C3AED?style=for-the-badge\u0026labelColor=0F172A\" alt=\"Category\" /\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003e ⭐ **If this agent-first tool helps your workflow, please star the repo.** Stars make this tooling easier for other builders to discover and help Delx keep shipping open infrastructure.\u003cbr\u003e\n\u003e 🧱 Part of the [Delx agent stack](https://github.com/davidmosiah) \u0026mdash; 15 open-source MCP servers across **body, reach and coordination**.\n\n---\n\n\u003c!-- /delx header v2 --\u003e\n\nProvider-neutral short-form AI video toolkit for agents. It gives Codex, Claude, Cursor, Hermes, OpenClaw and other MCP clients one interface for building dry-run payloads and, when explicitly enabled, generating vertical video through Sora/OpenAI, Gemini Veo, xAI/Grok and Seedance/PiAPI-style providers.\n\nUse it when an agent needs one safe interface for prompt-to-video payload validation and optional paid generation across multiple providers.\n\n## Why It Is Agent-First\n\nVideo generation can be expensive and prompt-sensitive. This package makes agents start with safe steps:\n\n- inspect provider readiness\n- return privacy boundaries\n- build payloads without spending credits\n- require `--live` or `SHORT_VIDEO_DRY_RUN=false` before provider calls\n- keep prompts and outputs in local user-controlled paths\n\n## Install\n\n```bash\nnpm install -g short-video-agent-kit\n```\n\nOr run directly:\n\n```bash\nnpm exec --yes --package=short-video-agent-kit -- short-video-agent-kit doctor\n```\n\n## Quickstart\n\nNo API key needed to try it — generation is dry-run by default, so the kit returns the exact provider-neutral plan it *would* send without spending a credit.\n\nBuild a Sora plan for an 8-second vertical teaser:\n\n```bash\nshort-video-agent-kit generate \\\n  --provider openai_sora \\\n  --prompt \"Vertical 8-second product teaser for a minimalist water bottle, soft studio light, slow dolly-in\" \\\n  --output ./output/teaser.mp4\n```\n\nReal output (no provider call, no credits spent):\n\n```json\n{\n  \"ok\": true,\n  \"dry_run\": true,\n  \"next_step\": \"Pass --live or set SHORT_VIDEO_DRY_RUN=false to call the provider API.\",\n  \"provider\": \"openai_sora\",\n  \"endpoint\": \"POST /v1/videos\",\n  \"payload\": {\n    \"model\": \"sora-2\",\n    \"prompt\": \"Vertical 8-second product teaser for a minimalist water bottle, soft studio light, slow dolly-in\",\n    \"seconds\": \"8\",\n    \"size\": \"720x1280\"\n  }\n}\n```\n\nSame prompt, different provider — the plan re-targets the endpoint and parameter shape for you. `payload` returns just the plan (no `dry_run` wrapper):\n\n```bash\nshort-video-agent-kit payload --provider gemini_veo --prompt \"Same teaser, 9:16, cinematic\"\n```\n\n```json\n{\n  \"provider\": \"gemini_veo\",\n  \"endpoint\": \"POST /models/{model}:predictLongRunning\",\n  \"payload\": {\n    \"instances\": [\n      {\n        \"prompt\": \"Same teaser, 9:16, cinematic\"\n      }\n    ],\n    \"parameters\": {\n      \"aspectRatio\": \"9:16\",\n      \"durationSeconds\": 8\n    }\n  }\n}\n```\n\nCheck which providers are wired up (keys are detected, never printed):\n\n```bash\nshort-video-agent-kit doctor\n```\n\n```json\n{\n  \"ok\": false,\n  \"dry_run\": true,\n  \"providers\": {\n    \"openai_sora\": { \"configured\": false, \"env_keys\": [\"OPENAI_API_KEY\"], \"models\": [\"sora-2\"] },\n    \"gemini_veo\": { \"configured\": false, \"env_keys\": [\"GEMINI_API_KEY\", \"GOOGLE_API_KEY\"], \"models\": [\"veo-3.1-fast-generate-preview\"] },\n    \"xai_grok\": { \"configured\": false, \"env_keys\": [\"XAI_API_KEY\"], \"models\": [\"grok-imagine-video\", \"grok-imagine-image\"] },\n    \"seedance_piapi\": { \"configured\": false, \"env_keys\": [\"PIAPI_KEY\", \"SEEDANCE_API_KEY\"], \"models\": [\"seedance-2-fast-preview\"] }\n  },\n  \"output_dir\": \"./output\",\n  \"next_steps\": [\n    \"Set one provider key: OPENAI_API_KEY, GEMINI_API_KEY, XAI_API_KEY or PIAPI_KEY.\"\n  ]\n}\n```\n\nWhen you are ready to actually render, set a provider key and re-run `generate` with `--live` (or `SHORT_VIDEO_DRY_RUN=false`).\n\n## CLI\n\n```bash\nshort-video-agent-kit manifest --client codex\nshort-video-agent-kit doctor\nshort-video-agent-kit privacy-audit\nshort-video-agent-kit payload --provider gemini_veo --prompt-file prompt.txt\nshort-video-agent-kit generate --provider openai_sora --prompt \"Vertical product teaser\" --output ./output/teaser.mp4\nshort-video-agent-kit generate --provider openai_sora --prompt-file prompt.txt --output ./output/teaser.mp4 --live\n```\n\nSupported providers:\n\n- `openai_sora`\n- `gemini_veo`\n- `xai_grok`\n- `seedance_piapi`\n\n## MCP\n\n```bash\nshort-video-mcp\n```\n\nHTTP transport:\n\n```bash\nSHORT_VIDEO_MCP_TRANSPORT=http short-video-mcp\n```\n\nHermes-style config:\n\n```yaml\nmcp_servers:\n  short_video:\n    command: npx\n    args: [\"-y\", \"short-video-agent-kit\"]\n    sampling:\n      enabled: false\n```\n\nRecommended first calls:\n\n1. `short_video_connection_status`\n2. `short_video_privacy_audit`\n3. `short_video_build_payload`\n4. `short_video_generate`\n\n## Agent Surfaces\n\n| Tool | Purpose |\n|---|---|\n| `short_video_agent_manifest` | Install/runtime guidance for Codex, Claude, Cursor, Hermes and OpenClaw |\n| `short_video_connection_status` | Provider readiness without API keys |\n| `short_video_privacy_audit` | Prompt, output and reference-asset boundaries |\n| `short_video_build_payload` | Provider-specific payload without paid generation |\n| `short_video_generate` | Dry-run by default, live only when explicitly requested |\n\n## Copy-Paste Agent Prompt\n\n```text\nUse short-video-agent-kit. First call short_video_connection_status and short_video_privacy_audit.\nBuild the payload before generation. Only set live=true if I explicitly confirm a paid provider call.\n```\n\n## Configuration\n\nCopy `.env.example` to `.env` and fill only the provider keys you plan to use. `.env`, `output/` and `.agent-data/` are ignored by Git.\n\n## Safety Model\n\n- Dry-run is the default.\n- API keys are never returned by tools.\n- Paid generation requires `--live`, MCP `live=true`, or `SHORT_VIDEO_DRY_RUN=false`.\n- Reference images must be user-owned or licensed.\n- Outputs are written to local paths controlled by the user.\n\n## Development\n\n```bash\nnpm install\nnpm test\nnpm run check\n```\n\n---\n\n## 📧 Contact \u0026 Support\n\n- 📨 **support@delx.ai** — general questions, integration help, partnerships\n- 🐛 **Bug reports / feature requests** — [GitHub Issues](https://github.com/davidmosiah/short-video-agent-kit/issues)\n- 🐦 **Updates** — [@delx369](https://x.com/delx369) on X\n- 🌐 **Site** — [wellness.delx.ai](https://wellness.delx.ai)\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidmosiah%2Fshort-video-agent-kit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdavidmosiah%2Fshort-video-agent-kit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdavidmosiah%2Fshort-video-agent-kit/lists"}