story-flicks

环境要求

• 已安装 Git
• 已安装 Docker 与 Docker Compose
• 一个可用的大模型 API Key（如 OpenAI、阿里云、DeepSeek、Ollama、SiliconFlow）
• Python 环境（后端为 Python + FastAPI，本地非 Docker 运行时需要）
• Node.js 环境（前端为 React + Vite，本地非 Docker 运行时需要）

安装与启动步骤

1. 1克隆项目

   把 story-flicks 仓库下载到本地，得到 backend 与 frontend 等目录。

   git clone https://github.com/alecm20/story-flicks.git

   复制

2. 2进入后端目录

   切换到后端目录，后续模型配置都在这里进行。

   cd backend

   复制

3. 3复制环境变量文件

   基于示例文件生成 .env，此文件用于填写各模型的供应商与密钥。

   cp .env.example .env

   复制

4. 4填写模型配置

   编辑 .env，设置 text_provider、image_provider 等；README 支持 openai、aliyun、deepseek、ollama、siliconflow。

5. 5Docker 一键启动

   在项目根目录执行，会构建并启动前后端服务，首次构建耗时较长。

   docker-compose up --build

   复制

6. 6打开前端页面

   启动成功后浏览器访问前端地址，输入故事主题即可生成视频。

关键配置

如何确认成功

容器启动无报错后，浏览器打开 http://localhost:5173/ 能看到前端界面即部署成功。

常见问题

注意事项

• 后端配置写在 backend/.env，由 .env.example 复制而来，切勿把真实密钥提交到 Git
• README 中的 image_provi 内容被截断，图片供应商的完整配置项请以项目内 .env.example 为准
• Docker 首次构建会拉取镜像并安装依赖，耗时较长，请保持网络稳定
• 本地非 Docker 运行需要分别启动 Python 后端与 React 前端，README 未提供对应命令