LibreAI / Video / FireRed-OpenStoryline
// video · FireRedTeam/FireRed-OpenStoryline

FireRed-OpenStoryline

An AI video editing agent — describe the story, and it plans and cuts the video for you.

★ 3.5k stars⑂ 405 forksApache-2.0updated 2026-07
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

FireRed-OpenStoryline is an open-source video project by FireRedTeam (FireRedTeam/FireRed-OpenStoryline on GitHub). It has 3,470 GitHub stars and 405 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 31 July 2026.

GitHub stars
3,470
Forks
405
License
Apache-2.0
Last updated on GitHub
31 July 2026
Category
Video
Listing
Full install guide
// how it works

How it works

  1. Clarify your goal

    Decide the first concrete outcome you want from it, so you can pick the right example, template or mode instead of exploring everything at once.

  2. Get the project

    Clone the repository (or install the published package) and skim its README quick start for the requirements for your platform.

  3. Install and configure

    Run the documented install step and set any required configuration — such as provider keys, data sources or local services — before the first run.

  4. Run your first task

    Execute the smallest documented example end to end, confirm the output is what you expected, then adapt it to your real data or workflow.

// features

Why people love it

Smart media search and organisation

Automatically searches online and downloads matching images/clips, then segments and understands your thematic media.

Intelligent script generation

Builds storylines and context-aware narration from your theme, visual understanding and emotion recognition, with few-shot style transfer.

Reusable Style Skills

Define a copy/editing style once (product reviews, casual vlogs and more) and reuse it across videos.

Human-in-the-loop creation

Transparent, reviewable steps instead of a black-box render.

Agent-native distribution

Installable as skills for OpenClaw, Claude Code, Codex and other compatible agents, or run standalone.

Docker deployment

Official images on Docker Hub and Alibaba Cloud registry for a containerised start.

Advertisement
// run it

Run it yourself

  1. Clone the repository

    Get the source so you can inspect, configure and run it locally.

    git clone https://github.com/FireRedTeam/FireRed-OpenStoryline.git
    cd FireRed-OpenStoryline
  2. Install the dependencies

    Clone, create a Python 3.11+ virtual environment and run the automatic installer (Linux/macOS) as the README describes.

    git clone https://github.com/FireRedTeam/FireRed-OpenStoryline.git
    cd FireRed-OpenStoryline  # then follow README section 3: resource download & installation
  3. Start the MCP server and UI

    Launch the server, then the CLI or the web interface on port 8005.

    PYTHONPATH=src python -m open_storyline.mcp.server
    uvicorn agent_fastapi:app --host 127.0.0.1 --port 8005
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains FireRed-OpenStoryline?

It is maintained by FireRedTeam on GitHub (FireRedTeam/FireRed-OpenStoryline), where the source, issues and releases live.

Is it free to use?

Yes — it is free and open source under Apache-2.0, which permits use, modification and commercial redistribution, with licence/notice retention.

Does it need a paid API key?

Yes — planning and understanding use LLM/media services, and the README documents API-key configuration for the providers you choose.

How does it compare to manual editing in Premiere or CapCut alone?

Compared with manual editing in Premiere or CapCut alone, FireRed-OpenStoryline's distinguishing focus is: an AI video editing agent — describe the story, and it plans and cuts the video for you. Pick it when that focus matches your need; the alternative may suit you better if its broader or different scope is the priority.

How do I get started?

Clone https://github.com/FireRedTeam/FireRed-OpenStoryline (or install its published package), follow the README quick start to install and configure it, then run the smallest documented example — the Run section on this page mirrors those steps.

// keep exploring

Similar tools

Video

Orkas-VideoStudio

Make your coding agent a video studio — describe it, get an MP4.

★ 497 starsMIT
View guide →
Video

interflow-video-cut

Agent skill that cuts talking-head videos into styled card videos.

★ 32 starsMIT
View guide →
Video

Nomi

An AI video workbench your coding agent directs — storyboard to render over MCP.

★ 549 starsAGPL-3.0
View guide →
Video

skills

HeyGen agent skills — avatar creation and video production pipelines.

★ 465 starsMIT
View guide →
Video

OpenCreator

Open-source AI workspace for creators, powered by Codex: video, image, voice, avatars and editing.

★ 12.6k starsApache-2.0
View guide →
Video

niulai-video-generator

Feed it a short story and it produces an abstract animated short in the style

★ 33 starsMIT
View guide →
// alternatives

Alternatives in Video

The most-starred other Video projects in the LibreAI catalogue — the realistic shortlist if FireRed-OpenStoryline is not the right fit.

Get FireRed-OpenStoryline

Free and open — grab the source, star the repo, and start creating.