claude-real-video安装教程macOS/Linux/Windows三大平台5分钟从零配置ffmpeg与Whisper一次搞定【免费下载链接】claude-real-videoLet Claude (or any LLM) actually watch a video — scene-aware, deduplicated frames transcript, from a URL or local file. Runs locally, MIT.项目地址: https://gitcode.com/gh_mirrors/cl/claude-real-videoclaude-real-video命令名crv是一个 MIT 开源的本地视频分析工具能让 Claude 或任何 LLM真正看视频它用场景感知的方式抽取关键帧、去重、并用 Whisper 做语音转写全程在你自己的机器上运行。本文是一份从零开始、覆盖 macOS / Linux / Windows 三大平台的完整安装教程核心就两步——装好ffmpeg再pip install带Whisper扩展的 claude-real-video5 分钟即可完成配置。一、claude-real-video 是什么为什么需要它把 YouTube 链接丢给 ChatGPT它读到的只是字幕文本而不是画面Claude 甚至无法直接接收视频文件。多数让 LLM 看视频的方案采用固定间隔抽帧每秒 1 帧快切镜头会漏掉静态录屏又会塞满上下文。claude-real-video 的做法不同方案claude-real-video抽帧方式固定间隔每秒 N 帧场景变化检测 密度保底重复镜头每次重复都会发送滑动窗口去重每个镜头只发一次音频常被忽略本地 Whisper 转写自动检测语言运行位置常常上传到云端完全本地运行你决定把什么交给 LLM装好之后一条命令就能把视频变成 AI 能读的证据包crv https://www.youtube.com/watch?v... # 输出crv-out/frames/*.jpg frames.json每帧时间戳 transcript.txt MANIFEST.txt二、安装前置条件Python 与 ffmpeg 一键配置1. 确认 Python 版本 ≥ 3.10python --version # 或 python3 --versionclaude-real-video 要求 Python 3.10见 pyproject.toml 中的requires-python声明。版本过低请先升级 Python 或使用 pyenv 等版本管理器。2. 三大平台 ffmpeg 一键安装步骤ffmpeg / ffprobe 用于抽帧和提取音频无法通过 pip 安装需要单独装一次。三大平台对应命令如下平台一键安装命令 macOSbrew install ffmpeg Linuxsudo apt install ffmpeg或用你发行版对应的包管理器 Windowswinget install Gyan.FFmpeg或choco install ffmpeg Windows 用户如果选择下载压缩包的方式记得把其中的bin\文件夹加入系统PATH否则 pip 装好后仍会报找不到 ffmpeg。安装后验证是否进入PATHffmpeg -version能打印出版本号就说明成功了。三、pip 安装 claude-real-video 并配置 Whisper打开终端执行pip install claude-real-video[whisper] # 推荐抽帧 去重 语音转写如果只需要抽帧和去重、不需要语音识别可以只装核心包pip install claude-real-video⚠️ 注意pip 的扩展extras不会自动安装漏掉[whisper]就意味着没有语音转写自带字幕的视频除外会直接用现成字幕。安装完成后你会获得这些命令crv主命令、crv-web本地网页版免终端、crv-ask跨视频搜索记忆、crv-mcpMCP 服务器定义都在 pyproject.toml 的[project.scripts]段中。四、验证安装成功3 条检查命令ffmpeg -version # 检查 ffmpeg 是否在 PATH 中 crv --help # 检查主命令可用及全部参数 python -m claude_real_video --help # crv 的别名写法等效三条命令都能正常输出说明环境已完全就绪可以进入第一次实战。五、第一次运行把视频变成 AI 能读的证据包用本地文件试跑一条命令crv lecture.mp4 -o out --lang zh运行结束后out/目录里会出现模型需要的全部内容frames/去重后的关键帧每帧都带源视频时间戳可引用如frame_012 00:03:41frames.json帧 → 时间戳映射transcript.txt/transcript.json带时间戳的转写文本MANIFEST.txt给模型看的阅读说明书把这些文件和几帧关键图丢给 Claude / ChatGPT / Gemini即可提问。想先看看模型将看到什么加--viewer生成一个本地viewer.html双击即可打开无需联网。同一 58 秒视频固定 1fps 抽帧得到 58 张图claude-real-video 只保留26 张真正有变化的还能用--grid拼成九宫格供模型阅读连续动作效果类似下面这张 NASA 发射视频的抽帧结果看看 --grid 输出长什么样--grid会把保留的帧拼成 3×3 联系表模型读到的是序列而不是零散静帧六、可选进阶配置faster-whisper 与 Apple Silicon 加速更快的转写[fast]扩展pip install claude-real-video[fast]装上后 crv 自动切换到 faster-whisper——同样的模型和输出速度快数倍并由 Silero VAD 把关纯音乐/静音音频会得到诚实的无语音标注而不是 Whisper 经典的幻觉字幕。Mac 用户专属[mlx]扩展M1–M4 GPU 转写pip install claude-real-video[mlx]借助 mlx-whisper 在 Apple Silicon GPU 上跑 Whisper一段 21 分钟的演讲faster-whisper 约需 6 分钟M4 上约 1 分钟。若 mlx 不可用会自动回退到 faster-whisper再回退到 CLI无需额外配置。其他按需扩展pip install claude-real-video[speakers]说话人分离、pip install claude-real-video[mcp]MCP 服务器。七、常见安装问题快速排查症状原因与解决ffmpeg: command not foundffmpeg 未安装或不在 PATH。按第二节重新安装Windows 记得把bin\加入 PATH有画面但没有转写未安装[whisper]扩展重新执行pip install claude-real-video[whisper]转写太慢加装[fast]全平台或[mlx]Apple Silicon输出目录报拒绝写入同一输出目录已有另一个视频的分析结果属于防混淆保护换目录或加--overwrite更多参数细节--scene、--max-frames、--adaptive、--text-anchors等可查阅项目根目录的 README.md命令行实现位于 src/claude_real_video/cli.py。八、相关项目文件导航完整文档与参数表README.md依赖与命令定义pyproject.tomlCLI 入口源码src/claude_real_video/cli.pyAgent 技能说明Claude Code / Cursor 等 50 宿主skills/claude-real-video-for-agents/SKILL.md技能一键安装脚本install-skill.sh装到这一步你的 AI 已经具备了看视频的能力——下一条crv命令就是它的第一眼。【免费下载链接】claude-real-videoLet Claude (or any LLM) actually watch a video — scene-aware, deduplicated frames transcript, from a URL or local file. Runs locally, MIT.项目地址: https://gitcode.com/gh_mirrors/cl/claude-real-video创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考