GitPodcast

几秒钟内即可将任何 GitHub 仓库转换为引人入胜的播客。

你还可以在任何 GitHub URL 中将 hub 替换为 podcast，以访问其播客。

🚀 特性

• 👀 即时播客：将任何 GitHub 仓库结构转换为播客
• 🎨 自定义：选择语音（开发中）
• ⚡ 快速生成：由 OpenAI 和 Azure Speech SDK 提供支持
• 🌐 API 访问：提供公共 API 用于集成（开发中）
• 💰经济高效：免费（通过 Gemini Flash + Azure Speech SDK）

⚙️ 技术栈

• 前端：Next.js、TypeScript、Tailwind CSS、ShadCN
• 后端：FastAPI、Python、Server Actions
• 数据库：PostgreSQL（配合 Drizzle ORM）
• AI：OpenAI 4o / Azure Speech
• 部署：Vercel（前端）、EC2（后端）
• CI/CD：GitHub Actions
• 分析工具：PostHog、Api-Analytics

🛠️ 自托管 / 本地开发

1. 克隆仓库

git clone https://github.com/BandarLabs/gitpodcast.git
cd gitpodcast

2. 安装依赖

pnpm i

3. 设置环境变量（创建 .env 文件）

cp .env.example .env

然后编辑 .env 文件，填入你的 OpenAI API 密钥用于 SSML，以及 Azure AI Speech Key 用于 TTS（https://azure.microsoft.com/en-us/pricing/details/cognitive-services/speech-services/）。

你也可以使用 Gemini Flash 来生成 SSML。此时需要将代码中的 OpenAIService 改为 GeminiService。

4. 运行后端

docker-compose up --build -d

日志可通过 docker-compose logs -f 查看。FastAPI 服务器将在 localhost:8000 上运行。

5. 启动本地数据库

chmod +x start-database.sh
./start-database.sh

当提示生成随机密码时，输入“yes”。Postgres 数据库将在容器中启动，地址为 localhost:5432。

6. 初始化数据库模式

pnpm db:push

你可以使用 pnpm db:studio 查看并操作数据库。

7. 运行前端

pnpm dev

现在你可以在 localhost:3000 访问网站，并在 backend/app/routers/generate.py 的 generate 函数装饰器中调整速率限制。

贡献

欢迎贡献！请随时提交 Pull Request。

致谢

特别感谢 [Romain Courtois/Ahmed Khalil] 的 Gitingest 和 Gitdiagram，它们为本项目提供了灵感和样式参考。

📈 速率限制

目前我以免费方式托管该项目，设置了以下速率限制。如果你想绕过这些限制，可以参考自托管说明。此外，我还计划添加用户自定义 OpenAI API 密钥的功能。

播客生成：

• 每分钟 15 次 API 调用，通过 Gemini Flash Exp. 2.0 将 GitHub 内容转换为 SSML
• SSML 到语音转换最多可处理 50 万字符（通过 Azure Speech Service）

🤔 未来计划

• 允许用户选择语音
• 移除对 Anthropic 的依赖及令牌数量限制
• 允许用户自定义提示

GitPodcast 快速上手指南

GitPodcast 是一个能将任意 GitHub 仓库瞬间转换为生动播客的工具。它利用 AI 分析代码结构并生成语音解说，支持自部署以突破免费版的速率限制。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统: Linux, macOS 或 Windows (需安装 WSL2)
• 运行时环境:
  • Node.js (推荐 v18+)
  • Python 3.9+
  • pnpm (包管理器)
• 容器化: Docker 及 Docker Compose
• API 密钥 (二选一或组合使用):
  • OpenAI API Key: 用于生成 SSML (脚本标记语言)
  • Azure AI Speech Key: 用于文本转语音 (TTS)
  • 可选: Google Gemini Flash API Key (可替代 OpenAI 以降低成本)

安装步骤

1. 克隆项目

将代码仓库克隆到本地并进入目录：

git clone https://github.com/BandarLabs/gitpodcast.git
cd gitpodcast

2. 安装依赖

使用 pnpm 安装前端及后端所需依赖：

pnpm i

3. 配置环境变量

复制示例配置文件并编辑 .env 文件，填入您的 API 密钥：

cp .env.example .env

编辑 .env 文件，配置以下内容：

• OPENAI_API_KEY: 用于 SSML 生成。
• AZURE_SPEECH_KEY 和 AZURE_SPEECH_REGION: 用于 TTS 语音合成。
• 注: 若使用 Gemini 替代 OpenAI，需修改代码中的服务类（将 OpenAIService 改为 GeminiService）。

4. 启动后端服务

使用 Docker Compose 构建并启动后端 FastAPI 服务：

docker-compose up --build -d

后端服务将在 localhost:8000 运行。可通过 docker-compose logs -f 查看日志。

5. 初始化本地数据库

赋予脚本执行权限并启动 PostgreSQL 数据库容器：

chmod +x start-database.sh
./start-database.sh

当提示生成随机密码时，输入 yes。数据库将运行在 localhost:5432。

接着推送数据库架构：

pnpm db:push

(可选) 如需可视化查看数据库，可运行 pnpm db:studio。

6. 启动前端

运行开发服务器：

pnpm dev

现在您可以在浏览器访问 http://localhost:3000 使用 GitPodcast。

基本使用

方式一：在线直接使用（无需安装）

如果您不想自部署，可以直接通过修改 URL 快速体验： 在任何 GitHub 仓库的 URL 中，将 hub 替换为 podcast。

示例： 原地址：https://github.com/BandarLabs/gitpodcast 播客地址：https://gitpodcast.com/BandarLabs/gitpodcast (或者直接访问 https://gitpodcast.com/ 并在输入框粘贴仓库链接)

方式二：本地自部署使用

完成上述安装步骤后：

1. 打开浏览器访问 http://localhost:3000。
2. 在输入框中填入任意公开的 GitHub 仓库地址（例如：https://github.com/vuejs/core）。
3. 点击生成，系统将自动分析仓库结构并生成播客音频。

提示: 自部署版本允许您修改 backend/app/routers/generate.py 中的速率限制装饰器，以解除免费托管版的调用次数限制。