Koma is a self-hosted AI video analysis website. Upload a video or paste a direct MP4 URL to generate a summary, chapters, searchable subtitles, and key frames. Click a result to return to that moment in the video, or export the analysis and custom data fields for your notes or spreadsheet.
Features
- Upload a local video or paste a downloadable MP4 URL (
.mp4paths, including signed query parameters). No third-party platform or share-link parsing. - Combine speech and key frames into summaries, chapters, tags, subtitles, and frame descriptions.
- Jump from a chapter, tag, subtitle, or frame to the matching moment. Search the transcript and export the result as Markdown or subtitles as SRT.
- Start with a lesson, interview/meeting, or product analysis. Describe the fields you need, review the editable JSON structure and field explanations before analysis, save it in the browser, and request JSON, CSV, Markdown, SRT, or TXT output.
- Sign in with GitHub to keep a private video workspace across browsers. Search and filter your recent jobs, reopen results, retry recoverable failures, or delete a job.
- With
ADMIN_PASSWORDconfigured,/adminseparately manages providers, encrypted API keys, and all jobs. GitHub sign-in does not grant administrator access.
Quick start
Requires Node.js 22.13+. FFmpeg and ffprobe are bundled.
npm install npm run dev
Open http://localhost:5173. Web analysis requires GitHub sign-in: configure the server-side GitHub App credentials and callback described in Configuration. The local CLI does not require a GitHub account.
Without provider keys, Koma uses mock output instead of real transcription or vision analysis. Configure an ASR provider for real subtitles and a vision provider for real summaries, chapters, frame descriptions, custom JSON, and generated files. See Configuration.
Data and privacy
Koma sends audio to the configured speech provider and key frames plus transcript context to the configured vision provider. Videos, frames, results, and generated files remain stored until their owner or an administrator deletes the job. New account-owned jobs are private: Koma checks owner or administrator access to their replay, video, frames, and downloads. When using OSS, an issued signed download URL remains usable by anyone holding it until it expires. Signing back in with the same GitHub account restores access across browsers. Custom analysis drafts and saved defaults remain local to that browser and are separated by account.
If saving a fully received video to OSS fails, Koma retains the complete local copy on the server so its owner can retry, and removes that copy when the job is deleted.
Older unclaimed replay links keep their previous read-only access. From the browser that submitted those jobs, you can explicitly move them into your account; this restricts future replay and stored-object access. Earlier downloads or cached public copies cannot be recalled. Jobs without proof of browser ownership are never automatically assigned. See Administration.
Uploads default to 500 MB and 15 minutes. Remote input must be a direct HTTP(S) MP4 file; platform pages, share text, playlists, and login- or subscription-protected links are not supported. Koma checks the response and file contents rather than trusting the filename alone. ADMIN_PASSWORD protects /admin; ANALYSIS_REQUIRE_ADMIN=true requires an administrator session in addition to GitHub sign-in. The URL importer is not a complete SSRF boundary, so use an egress policy or trusted URL allowlist before exposing submission to untrusted users.
CLI
npm run build node dist-server/cli.js demo.mp4 --lang en --json result.json node dist-server/cli.js --help