hello-agents/Co-creation-projects/JJason-DeepCastAgent/backend

DeepCast

📝 项目简介

DeepCast 是一个自动化播客生成智能体，具备深度全网调研能力。它不仅能够对用户给定的主题进行全网深度调研并生成专业报告，还能进一步将研究成果转化为生动的双人对谈播客（Podcast）。

DeepCast 旨在解决信息获取的"枯燥"问题，将严肃的深度研究报告转化为易于消化的音频内容，让用户可以在通勤、运动等场景下高效获取知识。

✨ 核心功能

• 深度全网调研：自动拆解问题，多轮搜索（Hybrid Search），生成结构化深度报告。
• 自动化脚本生成：将研究报告改编为 Host (Xiayu) 与 Guest (Liwa) 的对谈脚本。
• 高品质语音合成：基于 ECNU-TTS 生成逼真的双人对话音频。
• 一键播客生成：自动合成最终 MP3 文件，即刻收听。

🛠️ 技术栈

• 框架: HelloAgents
• 后端: FastAPI, Python 3.10+
• 模型支持:
  • 推理/脚本: ecnu-max, ecnu-reasoner
  • 语音: ecnu-tts
• 搜索服务:
  • 混合搜索 (Hybrid Search): Tavily + SerpApi (Google)
  • 备用方案: DuckDuckGo
• 音频处理: Pydub, FFmpeg

🚀 快速开始

1. 环境准备

• Python 3.10+
• uv 包管理器 (推荐)
• FFmpeg: 必须安装并配置到系统 PATH，或在配置中指定路径。

2. 安装依赖

cd backend
uv sync
# 或者使用 pip
# pip install -r requirements.txt

3. 配置环境变量

复制 env.example 为 .env 并填入必要的配置：

cp env.example .env

关键配置项：

• LLM:

  LLM_PROVIDER=custom
  LLM_MODEL_ID=ecnu-max
  LLM_API_KEY=your_key
  LLM_BASE_URL=https://chat.ecnu.edu.cn/open/api/v1
  

• TTS:

  TTS_API_KEY=your_key
  TTS_BASE_URL=https://chat.ecnu.edu.cn/open/api/v1/audio/speech
  TTS_MODEL=ecnu-tts
  

• 搜索 (推荐配置):

  SEARCH_API=hybrid
  TAVILY_API_KEY=your_tavily_key
  SERPAPI_API_KEY=your_serpapi_key
  

• 音频工具:

  # 如果 ffmpeg 不在系统 PATH 中，请指定绝对路径
  FFMPEG_PATH=C:\ffmpeg\bin\ffmpeg.exe
  

4. 运行项目

uv run src/main.py

🧪 验证脚本

项目包含一系列测试脚本，用于验证各组件配置是否正确：

• tests/verify_ffmpeg.py: 检查 FFmpeg 是否可用。
• tests/verify_search.py: 测试混合搜索（Tavily/SerpApi）是否连通。
• tests/verify_ecnu_tts.py: 测试 TTS 语音生成服务。

🤝 贡献指南

欢迎提出 Issue 和 Pull Request！

📄 许可证

MIT License