安装

添加到你的 Claude Code skills 目录：

# Add to your Claude Code skills
git clone https://github.com/MartinDelophy/ai-video-editor

安全报告

已验证

上次扫描：—

{
  "status": "PASSED",
  "issues": []
}

README.md

Timeline Studio — Browser AI Video Editor

Name: ai-video-editor
Author: MartinDelophy

Timeline Studio is launching on Product Hunt Aug 25 (PDT). Follow our page to share technical feedback on launch day!

Responsible use of deep synthesis

This tool uses deep-synthesis technology and is intended solely for technical research and learning.

Users must ensure that they:

use only facial images or videos of themselves or people who have provided lawful authorization;
do not create or distribute any illegal, infringing, false, or misleading content;
do not present generated content as authentic footage or impersonate another person without their consent.

Users are solely responsible for any legal liability arising from violations of these requirements.

Project updates

August 12, 2026 — Desktop color wheels: added a dedicated desktop Color Wheels tab before AI Repair, with separate shadows, midtones, highlights, and offset wheels plus temperature, tint, and saturation controls. All 15 grading properties support per-property keyframes, shortest-path hue interpolation, and matching animated preview, transition, and export rendering. Mobile keeps its focused video Speed workflow without exposing Color Wheels.
August 7, 2026 — v0.9.2 cross-platform Agent Skill: synchronized the complete edit-timeline-studio package across GitHub Releases, GitHub Skill installation, skills.sh, Codex, Claude Code, GitHub Copilot, and Gemini CLI. This release adds reference-video reconstruction, highlight and tension shaping, promotion narrative planning, provider-neutral footage sourcing, local model routing, explicit host dependency setup, Chinese/English voiceover preparation, and audio timing and loudness validation.
August 5, 2026 — v0.9.1 Agent Skill: published the professional auto-editing workflow through skills.sh and GitHub Skill installation. The Skill now classifies raw footage, product/tutorial videos, multi-shot highlights, multi-speaker conversations, and website walkthroughs; plans from multimodal image, speech, OCR, and motion evidence; guides stabilization, tracking, and deliberate enhancement; preserves sentence-level portable voiceover clips; and requires both a verified editable .timeline project and rendered video for completed edits.
July 31, 2026 — Face swap: replace the identity in a selected visual clip with browser-local face detection, tracking, and preview.
July 28, 2026 — v0.8.0: contributor onboarding and release documentation were refreshed.
See the public Roadmap for planned work, Releases for shipped changes, and Issues for focused tasks and bugs.

What can it produce?

Explore reproducible before/after examples and editing recipes:

→ AI Video Editing Skills Handbook

Timeline Studio is a local-first AI video editor that runs in the browser. It combines a CapCut-style multi-track timeline with WebGPU AI music and repair, multilingual voiceovers, automatic captions, talking-avatar generation, and deterministic offline export.

Open the editor · Watch on YouTube · Hugging Face Space

Video demo

Auto Edit

Visual analysis, keyframes, captions, and export.

https://github.com/user-attachments/assets/e8327caa-429e-40ff-a7fe-a59e6cf7a464

AI Repair

Timed watermark removal with before/after review.

https://github.com/user-attachments/assets/aea9f5b4-c720-4b0c-9067-5ec124eef982

AI Voiceover

https://github.com/user-attachments/assets/304a744e-d620-4380-9c17-19af3726f5a4

Timeline Studio editor

AI capabilities

Multilingual voiceover: Chinese and mixed Chinese/English Hojo TTS Light 80M FP16 reference voices (晴岚 and 若溪), with autoregressive generation on WebGPU and stable waveform decoding on WASM; English Kokoro 82M; and browser Piper voices for German, Spanish, French, Italian, and Brazilian Portuguese.
Local AI music: Stable Audio 3 Small Q4 ONNX runs through WebGPU with translated free-form prompts, 30/60/90/120-second choices, waveform-aware long-track looping, persistent model caching, and automatic insertion into My Assets.
Automatic captions: Whisper small q8 ONNX with waveform-aware timing and conservative Chinese recognition cleanup.
Smart framing: YOLOS tiny subject detection and MODNet portrait matting for smart crop, caption avoidance, and background removal across images and complete videos.
AI Repair: browser-local MI-GAN watermark/object removal with multiple timed repair regions, plus NanoVSR 644K WebGPU 4× restoration for images and videos with synchronized before/after comparison.
AI vocal separation: isolate vocals and place the instrumental stem on the music track without leaving the browser workflow.
Digital human: JoyVASA audio-to-motion and LivePortrait neural rendering with WebGPU, 256px preview and 512px quality paths.
Local-first inference: large models are lazy-loaded, revision-pinned, and cached by the service worker; supported workflows run without uploading project media to an editing backend.

Resilient model delivery

Browser AI models are mirrored on both Hugging Face and ModelScope. Timeline Studio uses ModelScope first for Chinese interfaces and domestic sessions, uses Hugging Face first elsewhere, remembers the first working source for the current runtime, and automatically falls back to the other source when needed. Cache identities are shared across both providers, so switching routes does not download the same revision twice.

Stable Audio: Hugging Face · ModelScope
Voice models: Hugging Face · ModelScope (mixed upstream licenses; see the repository model card)
Timeline Studio ONNX models: Hugging Face · ModelScope
Depth Anything V2 Small Q4F16: Hugging Face · ModelScope (Apache-2.0)
Vocal remover: Hugging Face · ModelScope

Editing and export

Contiguous main Visuals track plus timed picture-in-picture overlays.
Direct canvas selection, movement, proportional resize, rotation, masks, filters, effects, animation, speed, and explicit keyframes, plus desktop four-way color grading with fully keyframeable temperature, tint, saturation, hue, wheel saturation, and luminance controls.
Captions, stickers, voiceover, separated source audio, and music on independent timed tracks.
CapCut-style snapping, alignment guides, clip menus, split/duplicate/delete, timeline zoom, undo/redo, and portable .timeline projects.
Native media playback for a responsive preview; export uses a separate deterministic offline rendering path.
WebCodecs MP4/WebM composition with shared preview/export geometry, audio mixing, captions, overlays, effects, and MediaRecorder fallback.
Installable PWA with a cached app shell and multilingual UI.

Agent Skill

The repository includes the AI Video Editing Skill for Codex, Claude Code, Copilot and Gemini CLI, backed by edit-timeline-studio for planning, executing, and verifying editable video timelines.

It helps an agent:

inspect media and preserve the user's editing brief;
describe reversible edits with stable clip IDs and explicit timestamps;
operate the hosted or local editor through the browser compatibility path;
validate declarative edit plans with skills/edit-timeline-studio/scripts/validate_edit_plan.mjs;
verify track placement, transitions, captions, overlays, audible audio, and final export artifacts;
keep the editable .timeline project as the source of truth instead of returning only an opaque render.

The versioned headless command runner loads and inspects portable projects, validates revisioned JSON plans, applies supported operations transactionally, supports dry runs and idempotent operation IDs, and writes a new .timeline archive without rewriting its media files. It also renders the documented portable Visuals + Voiceover + Music subset to a verified H.264/AAC MP4. Browser control remains the compatibility path for richer compositions and operations that are not in the command registry yet.

npm run agent -- project.inspect /absolute/path/project.timeline
npm run agent -- track.inspect /absolute/path/project.timeline visuals
npm run agent -- clip.inspect /absolute/path/project.timeline visual-123
npm run agent -- transcript.inspect /absolute/path/project.timeline voice-123
npm run agent -- project.diff /absolute/path/edit-plan.json
npm run agent -- project.run /absolute/path/edit-plan.json
npm run agent -- project.render /absolute/path/render-request.json

The legacy inspect and run aliases remain available. The write registry supports ffprobe-backed, hashed visual/audio import to Visuals, Music, or the portable Voiceover slot, plus transactional timed edits, captions, source-accurate Visuals/Overlays, transitions, validated properties, track state, and ratio changes. Read commands return project, track, clip, transcript, media-inventory, and field-level predicted diffs. See the command contract for the plan envelope.

Install through the public skills.sh directory (the current CLI requires Node.js 22.20.0 or later):

npx skills add MartinDelophy/ai-video-editor --skill edit-timeline-studio

Or install it with GitHub CLI 2.90.0 or later:

# Claude Code
gh skill install MartinDelophy/ai-video-editor edit-timeline-studio --agent claude-code --scope user

# Codex
gh skill install MartinDelophy/ai-video-editor edit-timeline-studio --agent codex --scope user

To install the tested release instead of following the latest release, add --pin v1.0.0. Preview the Skill before installing with:

gh skill preview MartinDelophy/ai-video-editor edit-timeline-studio

Roadmap

Now: expand the versioned command registry, harden deterministic offline export, and improve timeline editing reliability.
Next: expand headless render parity and expose the shared command engine through MCP.
Later: add collaborative review workflows, a plugin extension surface, and more locally verified AI models.

Roadmap priorities are shaped in GitHub Discussions. Feature requests and real-world workflow feedback are welcome.

Help wanted

Timeline Studio is looking for contributors interested in browser media, WebCodecs, WebGPU/ONNX, timeline UX, localization, testing, and documentation.

Try the live editor and report reproducible bugs in Issues.
Join Discussions to propose features, share projects, or help prioritize the roadmap.
Read the contribution guide for setup, validation, and first-contribution guidance.
Contributions of focused fixes, tests, translations, documentation, and example projects are especially useful.

Quick start

Requirements: Node.js 20+ and a modern Chromium browser. WebGPU is recommended for the heaviest AI workflows.

git clone https://github.com/MartinDelophy/ai-video-editor.git
cd ai-video-editor
npm install
npm run dev

Open the local URL printed by Vite. The first AI run may download model files; later runs reuse the browser cache.

Validate and build

npm run build
npm run preview

Run the complete repository check with:

npm run check

Deploy

The included netlify.toml builds with npm run build, publishes dist, enables the cross-origin isolation headers required by browser AI/media workers, and provides the SPA fallback.

npx netlify-cli deploy --prod --dir=dist

Support and feedback

If this project helps you, please consider giving it a ⭐ Star. If you encounter a problem, please open an Issue.

Join our Discord community to ask questions, share feedback, and connect with other users and contributors.

License

Timeline Studio's original source code is licensed under the MIT License.

The MIT License does not automatically apply to third-party models, model weights, datasets, fonts, stock media, or other bundled or remotely downloaded assets. Those materials remain subject to their respective upstream licenses and terms, regardless of where they are hosted or how they are downloaded or integrated. Review MODEL_LICENSES.md before redistribution or commercial use.

常见问题

What is ai-video-editor?⌄

ai-video-editor is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by MartinDelophy. Local-first browser AI video editor with WebGPU AI music, AI repair, voiceovers, captions, talking avatars, and deterministic export. It has 471 GitHub stars.

Is ai-video-editor safe to use?⌄

ai-video-editor returned warnings in SkillsLLM's automated security scan. It has no critical vulnerabilities, but review the flagged issues in the Security Report section before adding it to your workflow.

How do I install ai-video-editor?⌄

Clone the repository with "git clone https://github.com/MartinDelophy/ai-video-editor" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is ai-video-editor written in?⌄

ai-video-editor is primarily written in JavaScript. It is open-source under MartinDelophy on GitHub, so you can review or fork the full source.

Are there alternatives to ai-video-editor?⌄

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh ai-video-editor against similar tools.

ai-video-editor

安装

快速入门