autoclip

环境要求

• Docker 20.10+ 与 Docker Compose 2.0+（Docker 部署方式）
• Python 3.8+（推荐 3.9+）；Node.js 16+（推荐 18+）
• Redis 6.0+（推荐 7.0+）
• FFmpeg（视频处理依赖，需自行安装）
• 内存最少 4GB（推荐 8GB+），存储最少 10GB

安装与启动步骤

1. 1克隆项目代码

   从 GitHub 拉取 AutoClip 源码并进入项目根目录，后续所有命令都在该目录执行。

   git clone https://github.com/zhouxiaoka/autoclip.git
   cd autoclip

   复制

2. 2配置环境变量

   把示例配置复制为 .env，然后填入通义千问 API 密钥等必要配置，否则 AI 分析无法工作。

   cp env.example .env

   复制

3. 3安装后端依赖

   在项目根目录安装 FastAPI、Celery、yt-dlp 等 Python 依赖，建议先建虚拟环境。

   pip install -r requirements.txt

   复制

4. 4安装前端依赖

   进入 frontend 目录安装 React 相关依赖，完成后返回项目根目录继续后续步骤。

   cd frontend && npm install && cd ..

   复制

5. 5启动 Redis 服务

   Redis 用于 Celery 任务队列与缓存，必须先启动；macOS 和 Linux 请二选一执行。

   brew services start redis  # macOS
   sudo systemctl start redis-server  # Linux

   复制

6. 6安装 FFmpeg

   README 仅将 FFmpeg 列为视频处理依赖，未给出安装命令，请按操作系统自行安装。

7. 7一键启动本地服务

   运行启动脚本会自动检查环境并拉起前后端与 Worker；开发时可用快速启动脚本跳过检查。

   ./start_autoclip.sh

   复制

8. 8Docker 方式启动

   推荐部署方式：先完成 .env 配置，再用 docker-compose 一次性拉起全部服务。

   docker-compose up -d

   复制

关键配置

如何确认成功

访问 http://localhost:8000 可打开接口文档，前端页面正常加载并能收到任务进度推送即成功。

常见问题

注意事项

• B站上传、字幕编辑、移动端支持和账号管理功能在 README 中标注为开发中，暂不可用。
• 生产环境建议用 PostgreSQL 替代 SQLite，并优化 Redis 内存与持久化、Celery 并发与任务路由。
• README 节选中未给出 git clone 与 FFmpeg 安装的具体命令，实际执行时请结合自身环境确认。