FireRed-OpenStoryline将复杂的视频创作转化为自然直观的对话体验。兼顾易用性和企业级可靠性,让视频创作对初学者和创意爱好者都变得简单友好。

项目简介


FireRed-OpenStoryline是FireRedTeam团队开源的一款基于 LLM/VLM 构建的自动化视频创作智能体。

它的核心理念很简单:用自然语言对话代替传统的手动剪辑操作。

"FireRed"这个名字取自"星星之火,可以燎原",代表了团队的愿景:把在真实商业场景中打磨出的顶尖技术能力,像火种一样传播给全世界的开发者,共同重塑 AI 视频创作的未来。


核心功能

🌐 智能素材搜索与整理:自动在线搜索并下载符合你需求的图片和视频片段。基于用户主题素材进行片段拆分与内容理解。

✍️智能文案生成: 结合用户主题、画面理解与情绪识别,自动构建故事线及契合的旁白。内置少样本(Few-shot)仿写能力,支持通过输入参考文本(如种草测评、日常碎碎念等)定义文案风格,实现语感、节奏与句式的精准复刻。

🎵智能推荐音乐、配音与字体:支持导入私有歌单,根据视频内容和情绪自动推荐背景音乐并智能卡点。只需描述"克制一点","偏情绪化","像纪录片旁白"等风格,系统即可匹配合适的配音与字体,保证整体风格协调统一。

💬对话式精修:支持快速删减、替换或重组片段;修改任意字幕文案;调整文字颜色、字体、描边、位置等视觉元素——所有操作均通过自然语言完成,即改即得。

⚡剪辑技能沉淀: 可一键保存为专属剪辑Skill,记录完整的剪辑逻辑。下次只需更换素材并选择对应Skill,即可快速复刻同款风格,实现高效批量生产。

新功能速递

这个项目更新速度特别快,从开源到现在才两个多月,已经推出了好几个重磅功能:

  • AI 转场生成:它能根据前一个片段的结尾帧和后一个片段的开头帧,加上自然语言描述,自动生成转场镜头,让场景切换更流畅,叙事更连贯。

  • ASR 粗剪技能:专门针对口播视频设计的功能。它能自动去掉语气词、口误和重复的句子,还能按时间戳对齐分段,让口播视频的剪辑更干净高效。

  • OpenClaw 集成:添加了两个 OpenClaw Skills —— openstoryline-install 和 openstoryline-use,分别覆盖初始安装/首次运行工作流和实际使用工作流。

快速上手

项目支持 Linux、macOS 和 Windows(Windows 需要手动设置),也提供了 Docker 镜像。

方法一:OpenClaw 一键安装(最简单)

如果你用 OpenClaw 或者 Claude Code,那太简单了,直接说:

"我想试试 OpenStoryline,帮我安装需要的 Skills"

它就会自动触发安装。

如果想手动安装:

openclaw skills install openstoryline-install
openclaw skills install openstoryline-use

如果 OpenClaw 版本不支持,也可以用 ClawHub:

npx clawhub install openstoryline-install
npx clawhub install openstoryline-use

方法二:手动安装(适合开发者)

① 克隆仓库

git clone https://github.com/FireRedTeam/FireRed-OpenStoryline.git
cd FireRed-OpenStoryline

② 创建虚拟环境

conda create -n storyline python=3.11
conda activate storyline

③ 下载资源并安装依赖

Linux 和 macOS 用户:

sh build_env.sh

Windows 用户:

需要手动创建 resource 目录,下载并解压 models.zip 到 .storyline 目录,下载并解压 resource.zip 到 resource 目录,然后安装依赖:

pip install -r requirements.txt

方法三:Docker(最省心)

拉取镜像:

# Docker Hub(推荐海外用户)
docker pull openstoryline/openstoryline:v1.0.1

# 阿里云镜像(推荐国内用户,更快更稳定)
docker pull crpi-6knxem4w8ggpdnsn.cn-shanghai.personal.cr.aliyuncs.com/openstoryline/openstoryline:v1.0.1

启动容器:

docker run \
  -v $(pwd)/config.toml:/app/config.toml \
  -v $(pwd)/outputs:/app/outputs \
  -v $(pwd)/run.sh:/app/run.sh \
  -p 7860:7860 \
  openstoryline/openstoryline:v1.0.1

启动后访问http://0.0.0.0:7860就能用 Web 界面了。

开始使用

重要提示:在开始之前,需要先在 config.toml 中配置 API Key,具体参考官方文档的 API Key 配置说明。

启动服务:

# MacOS 或 Linux
PYTHONPATH=src python -m open_storyline.mcp.server

# Windows
$env:PYTHONPATH="src"; python -m open_storyline.mcp.server

然后可以选择用命令行界面或 Web 界面:

# 命令行界面
python cli.py

# Web 界面
uvicorn agent_fastapi:app --host 127.0.0.1 --port 8005

基本使用流程

  1. 点击聊天框左侧的文件上传按钮,选择你的图片或视频
  2. 在输入框中输入你的剪辑目标,比如:"用我的素材剪一个闺蜜旅行的种草视频,风格活泼一点"
  3. 系统开始工作,你可以在任何阶段进行意图干预和部分重做
  4. 输出成片!

写在最后

FireRed-OpenStoryline 让我想起了一句话:技术的进步,就是把复杂的事情变简单。

以前,视频创作是专业人士的专利,需要昂贵的设备、多年的经验、大量的时间。现在,有了这样的工具,普通人也能轻松做出高质量的视频。

无论是想做自媒体的个人,还是需要批量生产内容的企业,FireRed-OpenStoryline 都能帮你节省大量的时间和成本。

更重要的是,它是完全开源的,你可以根据自己的需求进行修改和定制。

GitHub:https://github.com/FireRedTeam/FireRed-OpenStoryline