项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1577
使用教程
环境要求
- 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
同类项目推荐
awesome-openclaw-tips
开源
掌握OpenClaw实用技巧,让AI代理更稳更省更高效。
Practical OpenClaw tips for memory, reliability, cost, automation, and multi-agent w···
Agentero
开源
让 AI Agent 陪你从选题到实验全程干活
Unified research workspace for humans & agents — PDF Q&A with citations, Vault, wri···
Obsidian-MantouAI
开源
给 Obsidian 装上 AI 大脑,笔记秒变智能助手
MantouAI—— 让Obsidian变身智能助手
local-ci
开源
本地跑 GitHub Actions,失败暂停、原地重试,缓存不丢
Run GitHub Actions locally — pause on failure, retry in place, and keep caches on y···
MiniMax-MCP
开源
把 MiniMax 的语音/图像/视频生成能力一键接入你的 AI 工作流
Official MiniMax Model Context Protocol (MCP) server that enables interaction with p···
awesome-jev-live
开源
每2小时刷新,按证据分级帮你筛AI智能体工具
Awesome Jev — evidence-graded index of TypeSafe System One: SDKs, MCP tools, agents···
MCP-Universe
开源
一站式训练评测智能体工具调用能力
MCP-Universe is a comprehensive framework designed for RL training, benchmarking, an···
botpress
开源
拖拽搭建 GPT 智能体,一键部署到全渠道
The open-source hub to build & deploy GPT/LLM Agents ⚡️
AIlice
开源
说句话,AI 自动干活,全程不用你操心
AIlice is a fully autonomous, general-purpose AI agent.
