openclaw-easy/ViralMint
openclaw-easy/ViralMint has 203 GitHub stars and 49 forks. GitHot measured 0 stars in 24 hours and +7 in 7 days. Last checked 2026-11-18 03:04 UTC. Last push 2026-11-15.
实测星标增长
- 24小时
- 0
- 7天
- +7
- 15天
- 更新延迟
- 1个月
- 更新延迟
各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。
关于
Open-source video pipeline (clipper, script-to-video & more) — scout trends, clip long videos, generate captioned shorts, design motion graphics. Local-first, BYOK. AGPL-3.0.
人工智能README.zh-CN.md
原文ViralMint
面向创作者的开源、本地优先视频流水线
发现趋势 → 切片长视频 → 生成带字幕的短视频 → 设计动态图形 → 用 22 个本地工具精修。 全部在你自己的机器上运行。自带 API 密钥。中间没有任何 SaaS。零遥测。
快速开始 • 功能特性 • 免费能力 • BYOK • 参与贡献

在真正的时间轴上把长视频切成短视频——在它自己的帧上拖拽、吸附到句子边界,或者让 AI 先提议。发现选题、转写、脚本配素材成片、动态图形与 22 个剪辑工具,全都在同一个应用里。
手动创作者要在十几个标签页和应用之间来回折腾的事,ViralMint 用一条本地工作流全部搞定。 跨 YouTube、TikTok 和抖音发现热门视频,用本地 Whisper 转写并分析,把长视频切成可发布的短视频,用你选择的 AI 撰写原创脚本,渲染带字幕的素材视频——最后交给你一条成品 MP4,附带 AI 起草的标题、描述和标签,随时可以发布。可以在浏览器里驱动它,也可以在 Telegram、WhatsApp、Discord 或 Slack 上跟它聊。
✨ 为什么选择 ViralMint
| 🔒 100% 本地 | SQLite、本地 Whisper、本地 FFmpeg。你的脚本、转写、下载和生成的视频永不离开你的机器。 |
| 🔑 BYOK,无中间商 | 使用你自己的 Anthropic / OpenAI / OpenRouter / YouTube / Pexels 密钥(也可以接入任何兼容 OpenAI 接口的服务器,如 Ollama、LM Studio、vLLM),落盘时以 Fernet(AES-128-CBC + HMAC-SHA256)加密,直接发往服务提供方——中间没有任何 ViralMint 服务器。 |
| 🤖 是智能体架构,不是套壳聊天 | 各司其职的智能体——Planner、Scout、Download、Analyzer 和 Generator——由一个真正会去执行工作的流式 AI 对话统一编排。 |
| ✂️ 剪、生成或设计 | 通往成片的三条路:在真正的时间轴上从长视频剪出短视频;用脚本生成带字幕的素材视频;或者完全不用素材,直接创作动态图形。 |
| 📱 用手机随时随地掌控 | 通过 Telegram、WhatsApp、Discord 或 Slack 与规划智能体(Planner)双向对话——任务提醒也发到同一个会话里。 |
| 🆓 开箱即免费 | 本地 Whisper、Edge TTS(400+ 语音)、免版税音乐、Pexels 素材,以及 22 个内置工具(大多只靠 FFmpeg + Whisper)——最重的活儿花费 $0。只为你主动选择接入的 AI 付费。 |
经过实战检验:一套 2,900 个测试的 pytest 测试集 在每次提交时运行,另有一套浏览器测试装置端到端驱动真实应用。AGPL-3.0——尽管 fork、修改,并在其之上创业。
🎯 功能特性
🔍 Scout(发现)跨 YouTube、TikTok 和抖音(外加任意 yt-dlp 支持的站点,通过动态搜索)的多平台趋势发现,配合 AI 爆款评分、Google Trends 需求信号、播放增速分析,以及异常值检测(相对频道基线的 3×–20×)。 |
🧠 Analyze(分析)本地 Whisper 转写,长视频也处理得干净利落;外加 AI 洞察提取——钩子、结构、语气、留存风险、建议标题,以及一条可直接运行的复刻提示词——分段级评分,并附上具体的改进建议。 |
🎬 Generate(生成)完整流水线:AI 脚本 → TTS 配音 → 按关键词匹配的 Pexels 素材 → 感知短语的动态字幕(支持 CJK / 阿拉伯语 / 泰语)→ 音量均衡的背景音乐 → AI 缩略图 → 成品 MP4。 |
✂️ Clip Studio(切片工作室)一条长视频 → 众多可发布的短视频,在真正的时间轴上剪。在源视频自己的胶片条上拖拽,拖动手柄时实时看到这一刀的首帧和末帧,切点自动吸附到句子边界,绝不会从半个词开始。可以直接输入精确时间码、粘贴节目笔记里的时间,也可以让 AI 提议——它给出的片段会变成可以再调整、可以删除的色块,落地之前什么都不会渲染,并按钩子、流畅度、价值、趋势契合度和传播力打分。赶时间就用 Auto-cut(一键切):一次按下全部搞定,而且会先告诉你这意味着多少条片段。 |
🎞️ Motion Graphics(动态图形)第三种产出形态,画面里完全没有实拍素材:动态排版、数据卡片、下三分之一字幕条、产品展示。描述你想要的效果,AI 会写出真正的合成工程;再在内嵌的动画工作室里用时间轴、图层和检查器打磨,最后完全在你自己的机器上渲染。按需安装——安装包里并不包含它。 |
🗂️ Library(素材库)把你拥有的一切收进一个可筛选的视图——渲染成品、下载、每一个工具的产出、你的音乐目录。两个问题对应两个控件:标签页说明文件是什么(视频 / 图片 / 音频 / 文件),标记说明它从哪来(生成 / 编辑 / 来源),于是一个下载来的 mp3 不必二选一。切到按来源分组,就能看到一条下载和你用它做出的所有东西并排;在任意页面打开 Activity(活动) 即可查看正在进行的任务。 |
💬 Chat(对话)流式 WebSocket 对话,统一编排每一个智能体。说一句 「去发现做菜的视频」 或 「下载这个链接」,它就直接跑起来。可点按的快捷回复标签、绝不锁住输入框的追问,以及刷新后依然保留的富结果卡片。 对话会读取你的实时流水线——已下载但未切片、已生成但未发布、已发现但未下载——并主动建议价值最高的那一步,而不是干等你开口。 |
📲 Messaging(消息)通过 Telegram、WhatsApp、Discord、Slack 从手机双向对话。随时随地指挥规划智能体,并在任务完成时收到提醒——同一个智能体,不同的通道。 |
⬇️ 通用下载器底层由 yt-dlp 驱动——支持 YouTube、TikTok、Bilibili、Instagram、Twitter/X、SoundCloud、Vimeo,以及 1,800+ 其他站点。无水印、无广告、不限量。 |
🧰 22 个内置工具单一用途的小工具——字幕、重构图、GIF、变速、裁剪、字幕文件、水印、合并、自动缩放、音乐可视化、配音,外加 AI 助手(翻译、元数据、钩子分析、自动章节)。大多数 100% 本地运行于 FFmpeg + Whisper——无需 API 密钥。 每个都带内嵌的结果预览。 |
🆓 无需 API 密钥即可使用的功能
最烧钱的部分都是免费且本地的。你只为主动选择接入的 AI 付费。
| 功能 | 由谁驱动 | 费用 |
|---|---|---|
| 从 1,800+ 站点下载视频 | yt-dlp | $0 |
| 音频转写 | 本地 faster-whisper | $0 |
| 配音(400+ 语音,70+ 语言) | Edge TTS | $0 |
| 逐字动态字幕 | FFmpeg + ASS 字幕 | $0 |
| 背景音乐库 | 本地免版税曲库 | $0 |
| 音效自动铺放 | FFmpeg 合成 | $0 |
| 工具:重构图、GIF、变速、裁剪、水印、合并、自动缩放、音乐可视化、字幕文件…… | FFmpeg + Whisper | $0 |
YouTube / TikTok / Pexels 仍需免费的 API 密钥——链接见 BYOK 章节。
🚀 快速开始
前置依赖
| 工具 | macOS | Linux | Windows |
|---|---|---|---|
| Python 3.11+ | brew install python |
apt install python3.11 |
python.org |
| Node.js 18+ | brew install node |
apt install nodejs npm |
nodejs.org |
| FFmpeg | brew install ffmpeg |
apt install ffmpeg |
ffmpeg.org |
安装与运行
git clone https://github.com/openclaw-easy/ViralMint.git
cd ViralMint
python -m venv venv && source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env # optional — keys can also be set in the UI
python run.py
首次运行会安装前端依赖、构建 SPA、启动 API,并在浏览器中打开 http://localhost:16888。
📦 想用安装包? macOS、Windows 和 Linux 的预构建应用在 Releases 页面。macOS 版本仅适用于 Apple Silicon(M1 及更新机型);Intel Mac 请按上面的步骤从源码运行。
💡 还没有 API 密钥? 启动后打开「设置 → AI 提供方」,粘贴一个 Anthropic、OpenAI 或 OpenRouter 密钥即可。OpenRouter 是通往 300+ 模型的单一网关——一把密钥就能用上 Claude、GPT、Gemini、Llama 和 Mistral。想用自己的服务器?选择 OpenAI-compatible,填入它的 Base URL(例如 Ollama 的
http://localhost:11434/v1)和模型名即可,本地服务器无需密钥。Edge TTS、Whisper、FFmpeg 和 yt-dlp 无需任何配置即可离线工作。
从源码构建桌面应用(可选)
比起终端命令,更想要一个可点击的应用?一套自包含的 PyInstaller 流水线能从这份源码构建出 macOS 的 .dmg、Linux 的 .tar.gz 或 Windows 的 .zip——你的浏览器依然是界面。
PYTHON_BIN=./venv/bin/python VIRALMINT_VERSION=0.1.0-dev \
bash desktop/scripts/build-app.sh
产物会输出到 desktop/release/。首次构建约需 10–15 分钟(PyInstaller 打包是耗时大头)。跳过标志、签名/公证的环境变量以及冒烟测试步骤都写在 desktop/README.md 里。
🔑 自带密钥 (BYOK)
每把密钥都可以在 .env 或 应用内「设置」中按用户设置——谁被设置了就以谁优先。按用户设置的密钥在存储前会经 Fernet 加密(AES-128-CBC + HMAC-SHA256)。密钥直连服务提供方;ViralMint 中间没有任何后端服务器。
| 用于 | 提供方 | 在哪里设置 | 费用 |
|---|---|---|---|
| AI 对话、脚本撰写、分析 | Anthropic · OpenAI · OpenRouter · 任意 OpenAI 兼容服务器 | console.anthropic.com · platform.openai.com · openrouter.ai/keys · 你的服务器地址 —— 设置 → AI 提供方 | 按用量付费(本地服务器免费) |
| YouTube 发现 · 评论 · My Channels | YouTube Data API v3 | console.cloud.google.com/apis/credentials —— 设置 → 服务 API 密钥 | 每天免费 10K 配额 |
| 素材视频 | Pexels | pexels.com/api | 免费 |
| 高级配音(可选) | OpenAI TTS | platform.openai.com | 按用量付费 |
| TikTok / 抖音发现 | TikHub API(推荐) | tikhub.io | 有免费额度 |
| Telegram / Discord / Slack | Bot 令牌 | 设置 → Messaging | 免费 |
| 扫码配对 | 设置 → Messaging | 免费 |
⚠️ TikTok / 抖音会话 Cookie 发现 也作为高级兜底方案在设置中提供,但它违反平台的服务条款,而且平台看到「在活动」的正是那把 Cookie 对应的账号。除非你已明确接受这一风险,否则请使用 TikHub API 路径。 详见 LEGAL.md。
🏗️ 架构
┌────────────────────────────────────────────────┐
│ React 18 + MUI 7 SPA │
│ (served by FastAPI in production) │
│ Chat · Scout · Channels · Library │
│ Stock Video · Clip Studio · Motion Graphics │
│ Tools · Messaging · Settings │
└─────────────────┬──────────────────────────────┘
│ HTTP + WebSocket
▼
┌────────────────────────────────────────────────┐
│ FastAPI · localhost:16888 │
├────────────────────────────────────────────────┤
│ Planner Agent ─── streaming chat + actions │
│ Scout Agent ───── YouTube · TikTok · Douyin │
│ (+ yt-dlp dynamic search) │
│ Download Agent ── yt-dlp (1,800+ sites) │
│ Analyzer Agent ── Whisper + AI insights │
│ Generator Agent ─ Script → TTS → Stock → │
│ Captions → Music → MP4 │
│ Motion Renderer ─ local HyperFrames engine │
│ Messaging ─────── Telegram · WhatsApp · │
│ Discord · Slack │
└─────────────────┬──────────────────────────────┘
│
┌────────────────────────┼─────────────────────────┐
▼ ▼ ▼
┌─────────────────┐ ┌──────────────────────┐ ┌──────────────────┐
│ SQLite local │ │ storage/ on disk │ │ External APIs │
│ (encrypted │ │ videos · audio · │ │ (BYOK, direct) │
│ credentials) │ │ thumbnails · sfx │ │ │
└─────────────────┘ └──────────────────────┘ └──────────────────┘
技术栈
| 层 | 技术栈 |
|---|---|
| 后端 | Python 3.11+ · FastAPI · SQLAlchemy 2.0(异步)· SQLite · WebSockets |
| 前端 | React 18 · Vite · MUI 7 · Zustand · React Router 6 |
| AI(BYOK) | Anthropic Claude SDK · OpenAI SDK · OpenRouter(一把密钥用上 300+ 模型)· 任意 OpenAI 兼容服务器(Ollama、LM Studio、vLLM…) |
| 转写 | faster-whisper(本地、多语言、CPU int8) |
| TTS | Edge TTS(免费)· OpenAI TTS |
| 视频 | Pexels 素材 · FFmpeg · Ken Burns 图片兜底 |
| 字幕 | FFmpeg + ASS(逐字高亮动画) |
| 下载 | yt-dlp(1,800+ 站点) |
| 消息 | python-telegram-bot · discord.py · slack-sdk · neonize(WhatsApp) |
| 安全 | Fernet(AES-128-CBC + HMAC-SHA256)加密落盘凭据 |
📸 界面截图
📁 项目结构
ViralMint/
├── run.py # 🚀 Single entry point
├── launcher.py # System-tray launcher (optional)
│
├── backend/
│ ├── agents/ # Planner, Scout, Download, Analyzer, Generator
│ ├── api/ # REST + WebSocket endpoints
│ ├── core/ # AI client, BYOK key resolver, crypto, WebSocket manager
│ ├── messaging/ # Telegram / WhatsApp / Discord / Slack channels
│ ├── models/ # SQLAlchemy models
│ └── services/ # TTS, video gen, captions, music, yt-dlp, Whisper, …
│
├── frontend/
│ └── src/
│ ├── pages/ # Chat · Channels · Library · Stock Video · Clip Studio · …
│ ├── components/ # Reusable UI (chat, settings, videos, …)
│ ├── hooks/ # WebSocket, settings, jobs, source video
│ └── store/ # Zustand global state
│
├── tests/ # pytest suite (2,900+ tests)
├── storage/ # Downloaded videos, audio, generated output (gitignored)
│
├── requirements.txt
├── .env.example
├── CONTRIBUTING.md
├── SECURITY.md
└── LICENSE # AGPL-3.0
🤝 参与贡献
欢迎提交 Pull Request——修 bug、加新平台、加新消息通道、性能优化、文档,什么都行。请先读 CONTRIBUTING.md 了解流程与代码风格,并在提第一个 issue 前查阅 行为准则。
- 📋 最近变更: CHANGELOG.md
- 🐛 报告 bug: 新建 issue
- 💡 提功能需求: 新建 issue
- 🔐 安全漏洞: SECURITY.md——请勿 公开提 issue。
📜 许可证与负责任地使用
ViralMint 采用 GNU Affero 通用公共许可证 v3.0(AGPL-3.0) 授权(LICENSE)。
- ✅ 个人使用、商业使用、修改、再分发均免费
- ✅ 可以在它之上运营 SaaS
- ⚠️ 若你对外分发它(或将其作为公开的网络服务运行),必须以相同的 AGPL-3.0 条款公开修改后的源码
ViralMint 是一个你在自己机器上运行的工具。 维护者既不托管你的内容,也不代理你的 API 调用——每一步动作都是你在用自己的平台和密钥亲自完成。使用发现与下载功能前,请先读 LEGAL.md,弄清楚哪些是被认可的(YouTube Data API、Pexels)、哪些是自担风险的(TikTok/抖音会话 Cookie 发现),以及在各平台服务条款下你需要为哪些内容负责。
🙋 不想自托管?
在 viralmint.net 也有一个托管版本——同一套「发现 + 分析 + 生成」引擎,已签名并公证,无需接入任何 API 密钥(用预付额度替代 BYOK)。它是闭源的——对于宁愿不折腾自己密钥与安装的人,这是另一套取舍。完整对比 + FAQ:docs/hosted-vs-self-hosted.md。托管版最常用的入口:YouTube AI 切片工具、YouTube 视频下载器、AI 字幕生成器 和 AI 视频生成器。否则,你需要的一切都在这里——继续往下读,然后 python run.py。
⭐ 如果 ViralMint 对你有用,给它点个 Star
Star 是对这个项目帮助最大的一件事——它能吸引贡献者、解锁 awesome-list 收录资格,也向其他创作者宣告它值得一看。只需一次点击。
⭐ 给 openclaw-easy/ViralMint 点 Star
用 FastAPI、React、Whisper、FFmpeg,以及大量异步 Python 打造。
项目官网:viralmint.net · 源码:github.com/openclaw-easy/ViralMint · 许可证:AGPL-3.0






