# fastapi-agent

**Repository Path**: neptune46/fastapi-agent

## Basic Information

- **Project Name**: fastapi-agent
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-11-26
- **Last Updated**: 2024-11-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 视频处理服务

这是一个基于FastAPI的视频处理服务，提供场景检测和视频抽帧功能。

## 功能特点

1. 场景检测：使用PySceneDetect库对视频进行场景分割
2. 视频抽帧：使用FFmpeg每秒抽取一帧生成新视频
3. 实时进度更新：使用WebSocket实时显示处理进度
4. 异步处理：服务端异步处理视频，避免阻塞

## 环境要求

- Python 3.7+
- FFmpeg（需要安装并添加到系统环境变量）
- 所需Python包（见requirements.txt）

## 安装步骤

1. 克隆项目到本地

2. 创建并激活虚拟环境（可选）：
```bash
python -m venv env_fastapi
env_fastapi\Scripts\activate
```

3. 安装依赖：
```bash
pip install -r requirements.txt
```

4. 确保FFmpeg已安装并添加到系统环境变量

## 运行说明

1. 启动服务端：
```bash
cd server
python main.py
```
服务器将在 http://localhost:8000 启动

2. 运行客户端：
```bash
cd client
python client.py
```

3. 按照客户端提示输入：
   - 选择处理类型（1：场景检测，2：抽帧处理）
   - 输入视频文件的完整路径

4. 处理结果将保存在 `d:\tmp` 目录下：
   - 场景检测结果：`scenes_[时间戳].txt`
   - 抽帧视频：`extracted_[时间戳].mp4`

## 注意事项

1. 确保输入的视频文件路径正确且文件存在
2. 确保有足够的磁盘空间存储处理结果
3. 处理大型视频文件时可能需要较长时间
4. 确保d:\tmp目录存在且有写入权限

## 错误处理

- 如果遇到FFmpeg相关错误，请检查FFmpeg是否正确安装
- 如果遇到文件访问错误，请检查文件路径和权限
- 如果服务连接失败，请确保服务器正在运行