Repolode
Forget-C

Forget-C/Jellyfish

An end-to-end production workspace for AI-generated short dramas, covering script breakdown, storyboarding, asset consistency, video generation and export.

Stars
7,127
Forks
1,228
Open issues
9
Last commit
3 months ago

What is it?

Jellyfish is a production workspace for building short dramas with AI. It takes chapter scripts and uses AI to split them into shots, extract characters, scenes, props, costumes and dialogue, and then guides each shot through a preparation and confirmation flow before it reaches the generation stage.

The project keeps characters, scenes, props and costumes in a shared entity model so the same assets can be reused across shots, which helps keep identity and style consistent. Image and video generation, along with text processing, run as async tasks in one task center that tracks status, elapsed time, results and cancellation.

The stack is React with Vite on the frontend and FastAPI on the backend, with MySQL, Redis and RustFS for storage in the Docker Compose setup. It also includes multi-provider model management, prompt templates and an OpenAPI-generated frontend client.

Key features

  • 01Splits chapter scripts into shots and extracts characters, scenes, props, costumes and dialogue.
  • 02Manages shared characters, scenes, props and costumes for reuse across shots.
  • 03Requires shots to pass a readiness check before entering the generation workspace.
  • 04Runs image and video generation as tracked async tasks with cancellation.
  • 05Supports multiple model providers, default models per category and prompt templates.
  • 06Ships a Docker Compose setup and generates frontend API clients from OpenAPI.

Use cases

  • Producing short or micro-dramas in batches with AI-generated video.
  • Keeping recurring characters and locations visually consistent across many shots.
  • Building lesson or promotional videos that follow a story script.
  • Solo creators exploring vertical drama production workflows.

Quick start

  1. 1

    Copy the Docker Compose environment file

    cp deploy/compose/.env.example deploy/compose/.env
  2. 2

    Start the full stack with Docker Compose (frontend at localhost:7788)

    docker compose --env-file deploy/compose/.env -f deploy/compose/docker-compose.yml up --build

Things to know

  • Requires configuring external AI model providers and API keys to generate text, images, and video.
  • Setup involves multiple services (MySQL, Redis, RustFS storage) when run with Docker Compose.

In collections

Topics

FAQ

What is Jellyfish?
An end-to-end production workspace for AI-generated short dramas, covering script breakdown, storyboarding, asset consistency, video generation and export. Jellyfish is a production workspace for building short dramas with AI. It takes chapter scripts and uses AI to split them into shots, extract characters, scenes, props, costumes and dialogue, and then guides each shot through a preparation and confirmation flow before it reaches the generation stage.
Is Jellyfish free to use? What license does it have?
Jellyfish is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is Jellyfish still maintained?
Updated within 6 months. The last commit to Jellyfish was on Jul 30, 2026.
What can I use Jellyfish for?
Producing short or micro-dramas in batches with AI-generated video. Keeping recurring characters and locations visually consistent across many shots. Building lesson or promotional videos that follow a story script. Solo creators exploring vertical drama production workflows.
How do I install Jellyfish?
Copy the Docker Compose environment file: cp deploy/compose/.env.example deploy/compose/.env Start the full stack with Docker Compose (frontend at localhost:7788): docker compose --env-file deploy/compose/.env -f deploy/compose/docker-compose.yml up --build
Where can I get Jellyfish?
The source code and installation instructions are on GitHub: https://github.com/Forget-C/Jellyfish

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects