Director

用智能体编排视频生成与编辑，自动化视频工作流

Director 是一个面向下一代视频交互与工作流的 AI 智能体框架，基于 Python 构建。它旨在解决视频内容生成、编辑和处理过程中缺乏统一智能编排的问题，让开发者能够通过自然语言或结构化指令，驱动多个 AI 组件协同完成复杂的视频任务。其核心能力包括：集成 RAG（检索增强生成）来关联视频内容与外部知识，支持文本到视频的生成，提供视频编辑和处理的原生工具链，并内置与 OpenAI 等主流 LLM 的适配。框架强调模块化和可扩展性，允许开发者快速构建从视频检索、内容理解到自动化剪辑的完整智能体应用，从而降低视频 AI 应用的开发门槛，提升视频生产与交互的自动化水平。

开源 unknown 智能体

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1539

维护状态低维护

是否开源是

定价模式 unknown

项目数据

分类智能体

开发团队video-db

所属国家

官网地址https://chat.videodb.io

GitHubhttps://github.com/video-db/Director

定价模式unknown

价格说明定价信息待确认

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型agent,agent-framework,ai-agents,framework,llm,openai,rag,search,text-to-video,video-editing,video-processing,videodb

GitHub 星标★ 1539

30天Star增速

HF 下载量

上线时间2024-10-14 00:00:00

最近更新2026-09-23 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数5

使用教程

难度：入门约 15 分钟部署方式：本地安装 5 步

环境要求

Python 与 pip（由 setup.sh 安装/检查）
Node.js 22.8.0（setup.sh 通过 nvm 安装）
nvm（Node 版本管理工具，脚本依赖它安装 Node）
可用的 API Key，用于填写 .env 配置
Git（用于克隆仓库）

安装与启动步骤

1克隆仓库

把 Director 仓库下载到本地并进入项目目录，后续所有命令都在该目录下执行。
```
git clone https://github.com/video-db/Director.git
cd Director
```
2运行安装脚本

执行仓库自带脚本，它会用 nvm 安装 Node.js 22.8.0、安装 Python 与 pip，并为前端和后端分别创建虚拟环境。
```
./setup.sh
```
3配置环境变量

编辑项目中的 .env 文件，填入你的 API keys 以及其他配置项。不填会缺少所需凭据。
4启动应用

一条命令同时拉起后端与前端服务：后端监听 127.0.0.1:8000，前端监听 127.0.0.1:8080。
```
make run
```
5按需单独启动

只想调试某一端时，可分别启动后端或前端，端口与整体启动时一致。
```
make run-be
```

关键配置

配置项	必填	说明	示例
`.env 文件中的 API keys`	是	按 README 要求编辑 .env，填入 API keys 及其他配置选项	`sk-xxxxxxxx`

如何确认成功

后端 http://127.0.0.1:8000、前端 http://127.0.0.1:8080 均能正常访问，即启动成功。

常见问题

Q：只想跑后端或只想跑前端怎么办？

A：使用 make run-be 只启动后端，make run-fe 只启动前端；默认端口分别是 8000 和 8080。

Q：setup.sh 做什么？需要我手动装环境吗？

A：脚本会自动用 nvm 安装 Node.js 22.8.0、安装 Python 与 pip，并为前后端创建虚拟环境，一般无需手动安装。

Q：环境变量在哪里配置？

A：编辑项目里的 .env 文件，加入你的 API keys 和其他配置项，保存后再执行 make run。

Q：不想本地部署有别的选择吗？

A：README 提供了托管版本入口 chat.videodb.io，以及 Render、Railway 的一键部署模板链接。

注意事项

安装脚本依赖 nvm 来安装 Node.js 22.8.0，请确保本机 nvm 可用。
务必先完成 .env 中的 API keys 配置，再执行 make run。
后端默认地址为 http://127.0.0.1:8000，前端为 http://127.0.0.1:8080，可与 README 提供的链接对应核对。

核心亮点

深度集成 RAG 与视频内容，支持基于语义的视频检索与问答
提供从文本到视频、编辑到处理的端到端智能体工具链
基于 Python 和主流 LLM 适配，上手快且易于扩展

不足之处

项目尚处成长阶段，文档和社区生态有待完善
对视频处理性能和高并发场景的优化未明确

适用场景

自动化视频剪辑与后期制作流程
视频内容库的智能检索与问答系统
基于文本描述生成视频草稿或创意素材

替代项目

VideoDB、LangChain、CrewAI

项目介绍

Director 是智能体领域的开源项目，由 video-db 开发，2024 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,539）位列前 30%，在智能体分类中处于中上游。

近 42 天，它的 GitHub 星标从 1,511 增加到 1,539，净增 28。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-23。从国内网络环境看，可直接访问。

它主要面向的使用场景是：自动化视频剪辑与后期制作流程。同类可对比的替代方案包括 VideoDB、LangChain、CrewAI。

上一篇：harmonist

下一篇：sre