AI驱动的影视广告创作平台
你的创意，瞬间变成专业级短剧、广告、MV、品牌影片
🚀 快速开始 · ✨ 核心特性 · 📖 文档 · 🗺️ 路线图 · 🤝 贡献
📚 技术文档 | Technical Docs（可能需重写，仅供参考）
English | 简体中文
KunFlix 是一款专注于影视广告的AI内容创作Agent平台，将剧本写作、角色设计、视音频生成、资产管理和智能剪辑全链路打通，让创作者、广告公司和品牌方像拥有一个"私人好莱坞团队"一样，高效完成从0到1的完整影视作品。
|
人机协作或由智能体创作，无需人工干预 |
对话驱动的多智能体协作，复杂任务化繁为简 |
|
内置专用Skills，支持自定义扩展 |
剧本 → 角色 → 视音频 → 成片的无缝转化 |
|
基于积分的精细化消费，灵活定价 |
完整的用户管理、Agent监控、数据分析 |
KunFlix 专为影视广告与短剧创作打造的开放式AI内容创作生态：
| 模块 | 能力 |
|---|---|
| 📝 剧本创作 | 短剧脚本、广告文案、分镜脚本、角色 backstory |
| 🎭 角色构建 | 一致性角色形象、服装、表情、动作、场景设计 |
| 🎨 视觉设计 | 高清图片、海报、场景图、漫画风格素材 |
| 🎬 多媒体制作 | 视频生成、动画短片、短剧成片、广告宣传片 |
| 🔊 音频制作 | AI原声配音、背景音乐、音效、旁白同步生成 |
| ✂️ 资产管理 | 生成内容自动存为可复用资产 |
| 类别 | 技术 |
|---|---|
| 后端框架 |   |
| AI编排 | AgentScope 多智能体框架 |
| 数据库 | SQLite (开发) / PostgreSQL (生产) + SQLAlchemy |
| 前端框架 |    |
| 实时通信 | WebSocket + Server-Sent Events |
| 状态管理 | Zustand + React Context |
- Python 3.12+（AgentScope 2.0 强制要求；旧 3.10 venv 需删除重建）
- Rust 1.85+（仅当从源码编译 ripgrep 时需要；首次安装会触发，参见 UPGRADE.md）
- Node.js 20+
- Docker 24+（Docker 部署时需要）
- SQLite（开发）/ PostgreSQL（生产）
从 1.0 升级到 2.0 的开发者请先阅读 UPGRADE.md。
项目支持三种部署方式，覆盖云端生产、本地联调、纯开发全场景：
| 模式 | 命令 | 适用场景 | 跨平台支持 |
|---|---|---|---|
| ☁️ 云服务器 | bash scripts/init-letsencrypt.sh |
带域名 + HTTPS 生产环境 | Linux |
| 🐳 本地 Docker | bash scripts/init-local.sh |
个人开发全栈联调 | Win (Git Bash/WSL) / macOS / Linux |
| 🖥️ 非 Docker 开发 | python dev.py |
纯本地开发、热重载 | Win / macOS / Linux |
git clone https://github.com/KunLabAI/KunFlix.git
cd KunFlix
python dev.py自动完成：创建虚拟环境 → 安装依赖 → 初始化数据库 → 并行启动 Backend + Frontend + Admin 三个服务。
方式二：本地 Docker
git clone https://github.com/KunLabAI/KunFlix.git
cd KunFlix/deploy
bash scripts/init-local.sh一键拉起 PostgreSQL + Redis + Backend + Worker + Frontend + Admin 全栈容器。
方式三：云服务器生产部署
详见 DEPLOY.md，含 HTTPS 证书签发、Nginx 反代、安全加固等完整流程。
⚙️ 1. 后端配置
cd backend
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txt #安装所有依赖项
python scripts/seed_db.py # 初始化数据库
python main.py # 启动后端服务🎨 2. 前端配置
cd frontend
npm install
cp .env.local.example .env.local
# 编辑 .env.local 配置API地址
npm run dev📊 3. 管理后台配置
cd backend/admin
npm install
npm run dev| 服务 | 地址 |
|---|---|
| 🎭 剧场客户端 | http://localhost:3666 |
| 📊 管理后台 | http://localhost:3888 |
| 📖 API文档 | http://localhost:8000/docs |
进入后台管理端（http://localhost:3888），在 AI 供应商模块 输入对应 API Key：
- OpenAI/ Azure OpenAI
- Google Gemini
- xAI Grok
- MiniMax
- DeepSeek
- Dashscope（阿里百炼）
- 火山引擎/火山方舟
- Open Router
- 其他供应商后续支持
在 智能体管理页面 创建智能体：
- 填写智能体名称和描述
- 选择底层模型（如 Grok、Gemini等）建议使用多模态，目前发现Gemini对于艺术类支持很友善
- 开启预设能力（Skills）：根据需求启用图像生成、视频生成、音乐生成等技能
- 工具模块：开启 Skills 后，工具模块可以默认关闭
创建完成后，前端用户即可在 无限画布 中使用该智能体进行创作：
- 与智能体对话，描述创作需求
- 智能体自动调用已开启的技能生成内容
- 生成的图片、视频、音乐自动保存为可复用资产
KunFlix 使用 Resend 作为邮件服务商，用于注册验证、密码重置等场景的验证码邮件下发。在后台管理端 系统设置 → 邮件服务商 中创建一条 Resend 配置即可。
Resend 默认提供 onboarding@resend.dev 沙盒发件域，只能发到你 Resend 账号注册时填写的那个邮箱，足够本地调试。
| 字段 | 推荐填法 |
|---|---|
from_email |
onboarding@resend.dev |
from_name |
任意，例如 KunFlix Dev |
api_base_url |
留空（默认 https://api.resend.com） |
reply_to |
留空；若希望用户回复落到客服邮箱再填 |
is_default |
✅ 勾上（必须有且仅有一个默认服务商，验证码才会路由到它） |
is_active |
✅ 勾上 |
保存后，点 「测试发送」，收件人只能填你自己的 Resend 注册邮箱，能收到即打通。注册 / 改密走前端流程时，也只能用该邮箱测试。
想给任意邮箱发件 → 必须先验证自己的域名（见下文）。
要把验证码发给真实用户，需在 Resend 完成域名验证：
- 进入 Resend 控制台 → Domains → Add Domain（例如
kunflix.com） - 按提示在你的 DNS 服务商处添加 SPF / DKIM / DMARC 记录
- 等待 Resend 验证通过（状态变为绿色
verified） - 把
from_email改为该域名下的任意地址，例如noreply@kunflix.com、hello@mail.kunflix.com
💡 个人本地开发用
onboarding@resend.dev就够；正式上线前再做域名验证即可。
| 🎬 影视创作者 | 📢 广告与营销团队 | 🏢 企业与个人创作者 |
|---|---|---|
|
|
|
KunFlix/
├── backend/ # Python 后端服务
│ ├── admin/ # 后台管理系统 (Next.js)
│ ├── routers/ # API 路由模块
│ ├── services/ # 核心业务服务
│ ├── skills/ # 技能目录
│ └── ...
├── frontend/ # 剧场客户端前端
└── ...我们正在持续迭代 KunFlix，以下是即将推出的核心功能：
| 优先级 | 功能 | 状态 | 描述 |
|---|---|---|---|
| 🔴 高 | TTS 供应商补齐 | 📋 规划中 | 接入更多 TTS 供应商（Azure TTS、ElevenLabs、火山引擎等），提供更多音色选择 |
| 🟡 中 | TTS 节点功能 | 📋 规划中 | 在画布中增加 TTS 专用节点，支持文本转语音、语音克隆、多角色配音等功能 |
| 🟡 中 | 多智能体模块优化 | 🚧 进行中 | 优化多智能体协作的稳定性、任务分派逻辑和事件流显示 |
💡 欢迎通过 GitHub Issues 提交功能建议或投票支持你最期待的功能！
欢迎各种形式的贡献！
Fork → Branch → Commit → Push → Pull Request
| 渠道 | 地址 |
|---|---|
| 📧 邮件支持 | zack@kunpuai.com |
| 💬 GitHub Discussions | 社区讨论和技术交流 |
| 📚 文档中心 | 详细的使用指南和API文档 |
本项目基于 Apache License 2.0 许可证，并附带附加条款。详见 license 文件。
免费商用：在未修改源代码的前提下，可将本软件用于商业目的，无需支付费用。如果这款软件有帮助到您赚到了钱，不妨请开发者喝一杯咖啡，哈哈。☕
需商业授权的情形：
- 📦 对本软件进行二次开发、修改或衍生
- 👥 向企业客户提供支持 10 人或以上用户的多租户服务
- 🔧 将本软件预装或集成至硬件设备进行捆绑销售
- 🏛️ 向政府或教育机构提供大规模采购服务
如需申请商业授权，请联系：📧 zack@kunpuai.com
贡献的代码可能会被用于商业用途（包括云端服务等）。开发团队保留调整开源协议的权利。
使用本平台需遵守各AI服务提供商的使用条款：OpenAI · Google Gemini · xAI Grok · 火山引擎
Made with ❤️ by KunpuAI