PDF到播客:详细安装与配置指南
项目基础介绍
本项目是一个开源的NVIDIA AI蓝图项目,旨在帮助开发者构建一个将PDF文档转换为音频内容的应用程序。通过使用NVIDIA NIM(NVIDIA Inference Microservices)技术,该蓝图灵活且安全,能够在私有网络上运行,无需共享敏感数据即可提供可操作的洞察。
该项目主要使用Python编程语言,并依赖于多个开源框架和工具。
项目使用的关键技术和框架
- NVIDIA NIM:NVIDIA的推理微服务,用于构建灵活的AI应用。
- Docker:容器技术,用于部署和运行微服务。
- ElevenLabs:文本到语音转换服务。
- Redis:用于缓存的内存数据结构存储系统。
- MinIO:一个开源的对象存储服务。
准备工作
在开始安装和配置之前,请确保您的系统满足以下要求:
- 操作系统:Ubuntu 20.04或22.04
- Docker和Docker Compose:已安装并配置
- Git:已安装
- Python:已安装,建议使用虚拟环境
安装步骤
1. 克隆项目仓库
首先,使用Git克隆项目仓库:
git clone https://github.com/NVIDIA-AI-Blueprints/pdf-to-podcast.git
cd pdf-to-podcast
2. 设置环境变量
在项目目录中创建一个.env
文件,并设置以下环境变量:
echo "ELEVENLABS_API_KEY=your_key" >> .env
echo "NVIDIA_API_KEY=your_key" >> .env
echo "MAX_CONCURRENT_REQUESTS=1" >> .env
请将your_key
替换为您从ElevenLabs和NVIDIA获取的API密钥。
3. 安装依赖
使用以下命令安装项目依赖:
make uv
此命令将安装UV(一个用于管理Python依赖的脚本),创建一个虚拟环境,并安装项目所需的所有依赖。
4. 启动服务
使用以下命令启动所有服务:
make all-services
首次运行此命令时,docling
服务可能需要一些时间来拉取和构建。后续运行将更快。
5. 查看API文档
要查看Swagger API文档,可以在本地打开localhost:8002/docs
。
6. 生成播客
使用以下命令激活虚拟环境并运行测试脚本:
source .venv/bin/activate
python tests/test.py --target <pdf1.pdf> --context <pd>
请将<pdf1.pdf>
和<pd>
替换为您要转换的PDF文件路径。
以上步骤将帮助您成功安装和配置本项目,开始将PDF文档转换为音频内容。请确保遵循上述指南,以便顺利完成设置。