How voxgig/podmind works
Podmind is a podcast RAG application: podcast feeds and audio are ingested, transcripts and chunks are prepared for retrieval, and users ask questions through a web app or embeddable widget. The README documents AWS-backed serverless deployment and the local-monolith mode; the sampled ingestion code explicitly dispatches episode processing, and the widget explicitly posts chat queries. Many backend service-to-service and storage calls were not sampled, so those relationships are omitted or marked unverified rather than presented as observed calls.
Main entry points: process_episode.ts Episode processing · App.tsx Web application · chat_query.ts Chat query · ingest_podcast.ts Feed ingestion
Components 26
Podcast ingestion
- Feed ingestion
backend/src/srv/ingest/ingest_podcast.ts - Episode processing
backend/src/srv/ingest/process_episode.ts - Podcast processing
backend/src/concern/PodcastProcess/PodcastProcess.ts - Audio transcription
backend/src/srv/audio/transcribe_episode.ts
RAG processing
- Transcript chunking
backend/src/srv/chunk/chunk_transcript.ts - Transcript handling
backend/src/srv/chunk/handle_transcript.ts - Embedding storage
backend/src/srv/embed/store_embed.ts - Chat query
backend/src/srv/chat/chat_query.ts - Prompt assembly
backend/src/srv/prompt/build_prompt.ts
Backend services
- Widget query API
backend/src/srv/widget/web_chat_query.ts - Authentication
backend/src/srv/auth/auth-srv.ts - Entity management
backend/src/srv/entity/entity-srv.ts - User services
backend/src/srv/user/user-srv.ts - Prompt services
backend/src/srv/prompt/prompt-srv.ts - Monitoring
backend/src/srv/monitor/monitor-srv.ts
User interfaces
- Web application
frontend/src/App.tsx - Browser client setup
frontend/src/setup.ts - Public auth page
frontend/src/public/Public.tsx - Private views
frontend/src/private/Private.tsx - Search view
frontend/src/private/Search.tsx - Embeddable chat widget
widget/ask-island/src/voxgig-podmind-ask.island.tsx
Runtime platform
- Lambda runtime
backend/src/env/lambda/lambda.ts - AWS services
- AWS Bedrock LLM
- Deepgram
Other components
- Podcast publisher
Connections 19
- Podcast publisher → Feed ingestion: submits feed
- Feed ingestion → Episode processing: dispatches episode
backend/src/srv/ingest/ingest_podcast.ts - Episode processing → Podcast processing: delegates processing
- Episode processing → Audio transcription: requests transcription
- Audio transcription → Deepgram: transcribes audio
- Episode processing → Transcript chunking: prepares transcript
- Transcript chunking → Transcript handling: handles chunks
- Transcript handling → Embedding storage: creates embeddings
- Embedding storage → AWS services: stores vectors
- Chat query → Prompt assembly: builds prompt
- Chat query → AWS Bedrock LLM: queries model
- Embeddable chat widget → Widget query API: posts query
- Widget query API → Chat query: dispatches query
- Web application → Browser client setup: initializes client
frontend/src/App.tsx - Web application → Public auth page: routes public
frontend/src/App.tsx - Web application → Private views: routes private
frontend/src/App.tsx - Private views → Search view: renders search
frontend/src/private/Private.tsx - Browser client setup → Authentication: requests auth
frontend/src/setup.ts - Lambda runtime → AWS services: uses services