NarratoAI是一款利用AI大模型自动生成视频解说和剪辑的开源工具，通过Docker容器化部署可以快速搭建稳定的AI视频处理环境。本指南将详细介绍如何快速部署NarratoAI，实现一键视频解说功能。

【免费下载链接】NarratoAI 利用AI大模型，一键解说并剪辑视频； Using AI models to automatically provide commentary and edit videos with a single click. 项目地址: https://gitcode.com/gh_mirrors/na/NarratoAI

🚀 环境准备与系统要求

在开始部署之前，请确保您的系统满足以下要求：

• Docker：版本 20.10.0 或更高
• Docker Compose：版本 1.29.0 或更高
• 内存：至少 4GB RAM
• 存储空间：建议预留 10GB 以上磁盘空间

📦 一键部署流程

第一步：获取项目代码

git clone https://gitcode.com/gh_mirrors/na/NarratoAI
cd NarratoAI

第二步：配置API密钥

编辑配置文件 config.toml，填入您的LLM API密钥：

[app]
vision_litellm_api_key = "您的视觉模型API密钥"
text_litellm_api_key = "您的文本模型API密钥"

NarratoAI项目主界面，包含视频脚本配置、字幕设置等功能模块

第三步：执行部署脚本

使用项目提供的自动化部署脚本：

chmod +x docker-deploy.sh
./docker-deploy.sh

该脚本会自动完成以下操作：

1. ✅ 检查系统环境
2. ✅ 构建Docker镜像
3. ✅ 启动容器服务
4. ✅ 健康检查验证

⚙️ 核心配置详解

Docker Compose配置

项目提供的 docker-compose.yml 文件已经优化了服务配置：

services:
  narratoai-webui:
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - "8501:8501"
    volumes:
      - ./storage:/NarratoAI/storage
      - ./config.toml:/NarratoAI/config.toml
    restart: unless-stopped

存储卷映射

关键目录映射配置：

• ./storage → 视频文件存储
• ./config.toml → 配置文件
• ./resource → 资源文件

🔧 运维与监控

服务状态检查

# 查看服务状态
docker-compose ps

# 查看实时日志
docker-compose logs -f

# 健康检查
curl http://localhost:8501/_stcore/health

视频内容检查界面，支持预览、时间戳对比和旁白文本生成

常用运维命令

# 停止服务
docker-compose down

# 重启服务
docker-compose restart

# 重新构建镜像
./docker-deploy.sh -b

🎯 高级配置技巧

多模型支持

NarratoAI通过LiteLLM统一接口支持多种AI模型：

• 视觉模型：Gemini、OpenAI、Qwen
• 文本模型：DeepSeek、GPT-4、通义千问

性能优化建议

1. 内存优化：调整Docker内存限制
2. 网络优化：配置网络连接设置
3. 存储优化：使用SSD提升I/O性能

视频生成完成界面，显示处理结果和预览效果

💡 故障排除

常见问题解决方案

服务启动失败：

• 检查端口8501是否被占用
• 验证Docker服务状态
• 查看详细错误日志

API调用超时：

• 调整超时配置参数
• 检查网络连接状态
• 验证API密钥有效性

📊 部署成功验证

部署完成后，访问 http://localhost:8501 即可看到NarratoAI的Web界面。系统会自动进行健康检查，确保所有组件正常运行。

通过本指南，您可以在5分钟内完成NarratoAI的Docker部署，快速体验AI视频解说的强大功能！🚀

【免费下载链接】NarratoAI 利用AI大模型，一键解说并剪辑视频； Using AI models to automatically provide commentary and edit videos with a single click. 项目地址: https://gitcode.com/gh_mirrors/na/NarratoAI