Director 视频智能工作流
用自然语言编排视频搜索、剪辑、生成与交付工作流。
- Star 数
- ★ 1.6k
- 最近更新
- 9 个月前
- License
- MIT
- 主语言
- Python
- FA 评分
- 30/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 视频内容团队需要从上传素材中定位特定时刻，并立即生成可分享片段时。
- 不适合
- 希望完全脱离 VideoDB 云平台自托管视频基础设施的团队
- 不愿配置 Python、Node.js 与 .env API 密钥的轻量用户
- 需要成熟 HTTP API 文档做自动化集成的开发者
这个 Agent 能做什么，适合哪些场景？
Director 是一个用于构建视频智能体的框架，面向搜索、编辑、汇编和生成等复杂视频任务。其后端 Reasoning Engine 负责理解输入、拆分任务并协调多个智能体；对话式界面和视频播放器由关联项目 videodb-chat 与 videodb-player 提供源码。该项目建立在 VideoDB 的“video-as-data”基础设施之上，依赖其云端存储、索引与流媒体能力。运行后，后端监听 127.0.0.1:8000，前端监听 127.0.0.1:8080，并以进度更新和文本、视频、图片或搜索结果内容返回任务状态。它适合希望自托管视频交互层、并接受 VideoDB 作为核心视频基础设施的开发者与内容团队。
用户在聊天界面提出视频任务后，Reasoning Engine 保持上下文、选择并协调相应智能体，将任务拆分为可执行步骤。README 列出的操作包括视频摘要、在媒体库中搜索特定片段、创建剪辑、生成带配音的影片、配音、翻译和添加字幕，以及添加叠加层和提取帧。智能体可结合 LLM、数据库和其他 GenAI API，VideoDB 负责视频的云端存储、索引和流式交付。自定义智能体通过复制 backend/director/agents/sample_agent.py 创建；其 run() 方法可使用 TextContent、VideoContent、ImageContent 或 SearchResultContent，调用 push_update() 发送进度，调用 self.output_message.publish() 发布最终状态，并返回 AgentResponse。
- 视频内容团队需要从上传素材中定位特定时刻，并立即生成可分享片段时。
- 营销或创作者团队需要根据脚本生成带配音的完整视频时。
- 拥有大量媒体资产的团队需要为视频库建立索引，并通过对话方式检索内容时。
- 跨语言发布团队需要为视频翻译并添加目标语言字幕时。
- 开发者需要扩展既有工作流，新增能复用工具的自定义视频智能体时。
如何安装或部署这个 Agent？
环境要求为 Python 3.9 或更高版本、Node.js 22.8.0 或更高版本，以及 npm。执行：
git clone https://github.com/video-db/Director.git
cd Director
./setup.shsetup.sh 会通过 nvm 安装 Node.js 22.8.0、安装 Python 与 pip，并为前端和后端建立虚拟环境。随后编辑 .env 文件，填入项目所需的 API 密钥和其他配置；README 未列出具体环境变量名称或必需密钥清单。
如何使用这个 Agent？
完成 .env 配置后执行 make run，同时启动服务。前端地址为 http://127.0.0.1:8080，后端地址为 http://127.0.0.1:8000；可在聊天界面提交视频任务。仅启动后端可使用 make run-be，仅启动前端可使用 make run-fe。README 没有提供可复制的 HTTP API 请求示例，因此首个已文档化的交互入口是本地前端界面。
这个 Agent 有哪些优点和局限？
- 将视频搜索、剪辑、摘要、生成、配音和字幕等任务置于同一套多智能体编排框架中。
- 智能体开发流程明确：从 sample_agent.py 开始，并有 AgentResponse、内容类型和 push_update() 进度推送约定。
- 前后端可独立运行，且 README 提供 Render 与 Railway 部署入口。
- 利用 VideoDB 处理云端视频存储、索引与流式播放，而不是由应用自行搭建这些视频基础设施。
- 核心架构建立在 VideoDB 基础设施之上，采用时存在明确的平台依赖。
- 必须同时满足 Python、指定版本 Node.js、npm 和 .env API 密钥配置等运行条件。
- README 未公开具体环境变量名称、所需服务账户范围或 API 密钥清单。
- 未提供已文档化的 HTTP API 调用示例，自动化集成需要进一步查阅托管文档或代码。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Director 视频智能工作流 当前 | 30 · 缺口较多 | 自托管服务免费 + 模型费 | ★ 1.6k | 9 个月前 | Python | — |
| Hypit AI 视频工作流 | 71 · 存在缺口 | Agent 插件 / 技能免费 + 模型费 | ★ 28k | 1 天前 | TypeScript | Codex · Claude Code |
| Wonda CLI | 56 · 缺口较多 | 命令行工具付费 | ★ 159 | 6 天前 | TypeScript | Codex · Claude Code |
| Video Use | 54 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 31k | 28 天前 | Python | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：仓库未提供权限模型、用户确认机制、数据流透明性、敏感数据处理、依赖安全、外部影响、回滚或来源归属的说明。所有信任相关标准均未得到支持，因此得分为0。
证据显示：README和文档提供了架构和功能描述，但未提供测试或验证证据，自洽性仅部分支持。依赖可用性：列出了Python和Node.js要求，但未提供依赖锁定或完整性校验。失败消息：未提供错误处理或用户反馈机制。
证据显示：README明确了目标受众（开发者、创作者、团队）和多种场景（搜索、编辑、生成等），但未提供详细的边界说明。能力边界：未明确说明哪些任务不支持。触发精度：自然语言命令示例，但未定义精确的触发条件。环境适配：支持Mac、Linux、Windows (WSL)，但未提供详细的部署配置。
证据显示：README提供了架构概览、安装步骤、创建新代理的指南，但缺少已知限制、版本变更日志和明确的维护责任。许可证为MIT，但版权归属为个人（Ashutosh Trivedi），未验证。
证据显示：README描述了输出类型（TextContent, VideoContent等）和进度更新机制，但未提供实际输出示例。边际价值：提供了20+预构建代理和自定义能力，但未与其他方案对比。成本效益：未提供性能或成本数据。
证据显示：README中的声明（如“20+预构建代理”）未提供具体列表或验证。跨来源佐证：提供了YouTube演示和文档链接，但未提供独立验证。事实与推断分离：README混合了事实和营销语言，未明确区分。
- 源码中未见：最小权限约束只授予完成任务所需的权限：用专用账号或只读令牌，并限定可访问的目录和仓库。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：数据流向说明运行时观察它连接了哪些外部服务（代理或防火墙日志）；弄清数据去向之前不要输入敏感数据。
- 源码中未见：敏感信息处理使用专用、低权限、可随时吊销的 API 密钥，不要复用生产凭据，也不要让密钥出现在日志里。
- 源码中未见：依赖安全审查安装前固定版本并做一次依赖扫描（如 npm audit、pip-audit）；优先放在容器里运行。
- 源码中未见：外部影响披露先弄清它会写入、发送或修改哪些外部系统，用测试账号或测试仓库验证后再接入正式环境。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 源码中未见：来源归属可核验从官方仓库或包源安装，核对发布者和仓库地址，避免同名仿冒包。
- 仓库未提供任何安全或权限相关文档，部署前需自行评估风险。
- 依赖未锁定版本，存在供应链安全风险。
- README中的功能声明缺乏验证，建议实际测试后再使用。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
First v0.1.1
发布说明摘录
What's Changed * Add agents and config endpoint by @ashish-spext in https://github.com/video-db/Director/pull/1 * Ankit/add agents by @ankit-v2-3 in https://github.com/video-db/Director/pull/2 * fix: prompt clip by @ankit-v2-3 in https://github.com/video-db/Director/pull/3 * cleanup fe by @0xrohitgarg in https://github.com/video-db/Director/pull/4 * bump videodb-chat by @0xrohitgarg in https://github.com/video-db/Director/pull/5 * Agents: Add stream video agent, minor update in sample agent. by @ashish-spext in https://github.com/video-db/Director/pull/6 …在 GitHub 查看 ↗