openstoryline-install

Installs, configures, and launches FireRed-OpenStoryline from source on local machines.

3.4k|400|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/FireRedTeam/FireRed-OpenStoryline --skill openstoryline-install-fireredteam
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: openstoryline-install
Source: https://github.com/FireRedTeam/FireRed-OpenStoryline/tree/main/.claude/skills/openstoryline-install
Command: npx skills add https://github.com/FireRedTeam/FireRed-OpenStoryline --skill openstoryline-install-fireredteam

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Setting up FireRed-OpenStoryline from source involves many fragile steps: Python version checks, dependency installation, large model and resource downloads, config.toml API key setup, and starting MCP and web services. This Skill turns that error-prone process into a deterministic, verifiable workflow. ## Core Features & Use Cases - Guided Source Installation: Clones the repo, creates a repo-local .venv with Python >= 3.11, installs requirements, and runs download.sh for model weights and resource assets. - Configuration Management: Fills config.toml LLM/VLM model settings and API keys via scripts/update_config.py, including optional Pexels and TTS provider keys. - Verification & Troubleshooting: Validates imports and config loading, checks key resources exist, starts MCP and web servers, and diagnoses common issues like slow downloads or port binding failures. - Use Case: A developer clones FireRed-OpenStoryline and asks the AI to get it running locally; the Skill detects prerequisites, builds the environment, downloads resources, configures keys, and confirms both services are listening. ## Quick Start Install OpenStoryline from this repository, configure my API keys in config.toml, and start the MCP and web services.

Frequently Asked Questions about openstoryline-install

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install FireRed-OpenStoryline from source?▼

Create a Python >= 3.11 virtual environment in the repo root, install requirements.txt with pip, then run download.sh to fetch model weights and resources. Finally fill config.toml with your LLM and VLM API keys before starting the services.

What prerequisites does OpenStoryline installation require?▼

You need git, Python 3.11 or higher, ffmpeg, wget, and unzip installed on macOS, Linux, or WSL. Docker and conda are optional alternatives for environment management.

How do I configure API keys in OpenStoryline config.toml?▼

Use scripts/update_config.py with --set flags to fill llm.model, llm.base_url, llm.api_key and the equivalent vlm settings. Optional keys include search_media.pexels_api_key and TTS provider keys under generate_voiceover.providers.

Why does the OpenStoryline web or MCP server fail to bind?▼

Binding failures with 'operation not permitted' usually come from sandbox restrictions on local listening ports. Request port permission in agent sandboxes and prefer 127.0.0.1 over 0.0.0.0 unless external access is required.

What should I do when download.sh is slow or interrupted?▼

Let wget continue since it supports resume behavior for the large model and resource archives. Verify the extracted outputs exist, such as .storyline/models weights and resource/bgms, rather than trusting the progress meter.