KnowClip-ai / knowclip

# KnowClip 智能剪辑
**KnowClip AI 智能剪辑**的开源核心（Tauri 2 + React + Python FastAPI）。
给一个几小时的长视频（课程 / 访谈 / 直播回放 / 播客），KnowClip 用本地 Paraformer 模型转出
带字级时间戳的语音识别结果，交给 LLM 分析出多个适合发短视频平台的精彩片段（含标题、描述、
话题标签、评分），你在片段卡片上勾选后批量导出——ffmpeg 流复制，不解码不编码，速度最快。
 [code] 
- **隐私**：视频素材不出本机，ASR 识别完全在本地运行
- **低成本**：唯一花钱的是你自己的 LLM API Key，用多少花多少
- **快**：导出走 ffmpeg 流复制，以毫秒级导出视频片段
English · 完整版官网 
## 环境要求
- macOS (Apple Silicon / Intel) 或 Windows
- Python 3.10+、Node.js 18+、Rust toolchain（Tauri 2）
- **ffmpeg / ffprobe**（加入 PATH）：`brew install ffmpeg` 或 `winget install ffmpeg`
## 快速开始
 [code] 
一键脚本会自动完成：创建 Python 虚拟环境 → 安装后端依赖 → 安装前端依赖 → 启动后端（127.0.0.1:8000）与桌面窗口。退出时按 `Ctrl+C` 同时关闭前后端。
 手动分步启动（可选） 
 [code] 
首次识别会自动从 ModelScope 下载 Paraformer 模型（约 1GB，缓存在 `~/.cache/modelscope`），之后直接复用。
## LLM 设置
在应用内设置面板填写（OpenAI 兼容三件套）：
| 项 | 说明 |
|---|---|
| API Key | 必填 |
| Base URL | 已预填 DeepSeek 官方地址（OpenAI 兼容格式）；改用 Kimi / GLM / OpenAI 及自建服务时直接改写 |
| 模型名 | 点「获取模型列表」后从下拉框选择（自动拉取该服务支持的模型） |
填好地址和 Key 后，点「获取模型列表」自动拉取该服务的可用模型，在面板外部的下拉框中选择即可。
内置提示词可在面板中修改，输出为自由文本，对模型无格式要求。
## 仓库结构
 [code] 
## 关于本仓库
本仓库是 KnowClip 的开源版本，**目的是给大家学习参考**一条完整链路的实现：
本地语音识别 → LLM 挑选精彩片段 → 批量导出。
为了让代码更好读、更好理解，我们把主链路之外的功能都去除了：
- **不包含画面加工** — 字幕烧录、贴纸、滤镜、竖屏、BGM 等均已精简
- **无账号、无内置计费** — ASR 本地运行，LLM 用你自己的 Key
> [!NOTE]
> 导出使用 ffmpeg `-c copy` 流复制，切割点会吸附到关键帧，片段开头可能多出零点几秒内容——这是换取极速导出的固有权衡。
> 后端仅监听本机 127.0.0.1 且无鉴权，仅供本机使用，请勿将端口暴露到公网。
需要完整功能请使用 KnowClip 完整版。
## 开发故事
做这个工具的路上踩了不少坑。我把选型过程、踩过的坑和取舍，写成了一系列文章，见 docs/articles/。
## License
AGPL-3.0（名称与 logo 为商标，AGPL 授权不含商标使用权，详见 THIRD_PARTY_NOTICES.md，其中亦列明 ASR 模型等第三方组件许可）。
---
# KnowClip
The open-source core of **KnowClip AI** (Tauri 2 + React + Python FastAPI):
 [code] 
- **Private**: video footage never leaves your machine; ASR runs fully locally.
- **Cheap**: the only cost is your own LLM API key.
- **Fast**: exports use ffmpeg stream copy — clips export in milliseconds.
## Quick start
 [code] 
The script bootstraps everything on first run (Python venv, backend & frontend deps),
then starts the backend (127.0.0.1:8000) and the desktop window. Press `Ctrl+C` to stop both.
The Paraformer model (~1GB) downloads automatically from ModelScope on first run.
Requirements: Python 3.10+, Node 18+, Rust toolchain, ffmpeg on PATH.
The Paraformer model (~1GB) downloads automatically from ModelScope on first run.
Any OpenAI-compatible endpoint works in the settings panel —
DeepSeek / Kimi / GLM / OpenAI and self-hosted servers all fine.
## About this repo
This repo is the open-source version of KnowClip, published as a **learning reference** — it shows one complete pipeline end to end: local speech recognition → LLM highlight picking → batch export.
To keep the code easy to read and understand, everything outside this main pipeline was stripped:
- **No rendering pipeline** — subtitle burning, stickers, filters, vertical reframing, and BGM are all removed
- **No account, no built-in billing** — local ASR; bring your own LLM key
Need the full toolbox? KnowClip
License: AGPL-3.0. The KnowClip name and l