DocsPodcast
github.com
What it is
DocsPodcast is a free, MIT-licensed project that turns uploaded documents into AI-generated, multi-speaker podcast conversations and answers questions about their contents. It accepts PDF, DOCX, DOC, and TXT files, with uploads limited to 0.5 MB (512 KB). Its retrieval pipeline stores document chunks in ChromaDB for semantic search and grounds answers in the source material. Podcast scripts support conversations between two and four speakers, combining generated segments into one MP3 file. The documented providers are OpenRouter with GPT-4o-mini, Google Gemini as a fallback, Gemini TTS, and gTTS as a speech fallback. English and Arabic are listed for question answering, scripts, and audio. The responsive interface works on mobile and desktop and renders Markdown tables, code blocks, blockquotes, and lists. Deployment documentation covers local hosting with Python 3.9+ and required OpenRouter and Google Gemini API keys. It is available for self-hosted, web, and Windows use, with a linked live demo.
Spec sheet
- Purpose
- DocsPodcast turns documents into AI-generated multi-speaker podcasts and supports question answering about uploaded files.Read 9 Oct 2026 · github.com
- Product
- DocsPodcast turns documents into AI podcast conversations and supports question answering about their contents.Read 4 Oct 2026 · github.com
- Deployment
- The project documents a local setup using Python 3.9 or later and Flask, and links to a live demo.Read 9 Oct 2026 · github.com
- Security
- The README says API keys are kept in an uncommitted .env file, filenames are sanitized, rendered HTML is sanitized with DOMPurify, and user data is sent to third parties only for AI API calls.Read 9 Oct 2026 · github.com
- License
- The repository states that the project is licensed under the MIT License.Read 4 Oct 2026 · github.com
- AI integrations
- The documented AI services are OpenRouter with GPT-4o-mini, Google Gemini, Gemini TTS, and Google TTS (gTTS).Read 9 Oct 2026 · github.com
- AI providers
- The README describes OpenRouter with GPT-4o-mini as the primary text-generation provider, Gemini as a fallback, Gemini TTS, and gTTS as a TTS fallback.Read 4 Oct 2026 · github.com
- Data handling
- The README says no user data is sent to third parties beyond AI API calls.Read 4 Oct 2026 · github.com
- Document formats
- It supports PDF, DOCX, DOC, and TXT uploads.Read 9 Oct 2026 · github.com
- Document Q&A
- Its RAG pipeline stores document chunks in ChromaDB for semantic retrieval, and answers are grounded in document content.Read 4 Oct 2026 · github.com
- File size limit
- The maximum document size is 0.5 MB (512 KB), enforced on both the client and server.Read 9 Oct 2026 · github.com
- Intended audience
- The maker describes the project as a way to turn documents into podcasts or chat with files; the repository lists PDF, Word, and text document support.Read 9 Oct 2026 · github.com
- Interface
- The README describes a responsive interface for mobile and desktop with a dark theme and rich Markdown rendering.Read 9 Oct 2026 · github.com
- Languages
- The README lists English and Arabic for Q&A, podcast scripts, and TTS audio.Read 9 Oct 2026 · github.com
- License and contributions
- The repository says the project is MIT-licensed and welcomes contributions through pull requests.Read 9 Oct 2026 · github.com
- Podcast generation
- It generates natural multi-speaker conversations with 2–4 speakers and combines generated segments into one audio file.Read 4 Oct 2026 · github.com
- Podcast voices
- Podcast scripts support conversations between two to four speakers, with Gemini TTS and Google TTS listed as the primary and fallback voice-generation options.Read 9 Oct 2026 · github.com
- Question answering
- Its RAG pipeline stores document chunks in ChromaDB and grounds answers in the document content.Read 9 Oct 2026 · github.com
- Setup
- Self-hosting instructions require Python 3.9+ and OpenRouter and Google Gemini API keys.Read 4 Oct 2026 · github.com
Strong points and limits
Strong points
- Accepts PDF, DOCX, DOC, and TXT files
- Grounds answers in document content
- Creates two- to four-speaker conversations
- Supports English and Arabic
- Released under the MIT License
Limits
- Uploads are limited to 0.5 MB
- Requires OpenRouter and Google Gemini API keys
- AI calls send data to third parties
- Self-hosting requires Python 3.9 or later
Who it suits
It suits people who want to turn documents into podcasts or chat with uploaded files. Developers can self-host it with Python 3.9 or later and the required AI API keys.
Verdict
DocsPodcast combines document Q&A with generated multi-speaker audio and supports two languages. Its small upload limit and dependence on external AI API keys are important setup constraints.
Where Specifiction places it
- AI Podcast Generators#18 of 237.3