How joolaoye/pulse works
Pulse turns a configured X list and interest profile into a generated podcast episode and RSS feed. Users configure shows, pipelines, and schedules through the CLI, then run manually or on a schedule. The documented episode workflow retrieves conversations, filters and groups signals, plans and scripts an episode, synthesizes audio, and publishes it. The graph also includes configuration, orchestration, and Cloudflare persistence/runtime capabilities. Workflow edges are based on README statements; sampled source confirms selected configuration and runtime wiring, but not every processing-stage connection.
Main entry points: workflow_runner.py Workflow Orchestrator · main.py Pulse CLI · run_manager.py Run Manager · pipeline.py D1 Repositories
Components 25
Show Configuration
- Pulse CLI
src/pulse/cli/main.py - Show Manager
src/pulse/application/configuration/show_manager.py - Pipeline Manager
src/pulse/application/configuration/pipeline_manager.py - Schedule Manager
src/pulse/application/configuration/schedule_manager.py
Episode Workflow
- X Retrieval
src/pulse/services/retrieval/x_retriever.py - Signal Ingestion
src/pulse/services/ingestion/ingestor.py - Signal Processing
src/pulse/services/signals/semantic_processor.py - Theme Grouping
src/pulse/services/grouping/signal_group_builder.py
Episode Generation
- Episode Planning
src/pulse/services/planning/episode_planner.py - Script Generation
src/pulse/services/scripting/script_generator.py - Audio Production
src/pulse/services/audio/producer.py - Podcast Publishing
src/pulse/services/publishing/podcast_publisher.py
Runtime Platform
- Run Manager
src/pulse/application/execution/run_manager.py - Workflow Orchestrator
src/pulse/application/orchestration/runner/workflow_runner.py - Cloudflare D1
src/pulse/infrastructure/db/d1/client.py - D1 Repositories
src/pulse/infrastructure/db/repositories/pipeline.py - Vectorize Store
src/pulse/infrastructure/vector/vectorize/client.py - R2 Object Store
src/pulse/infrastructure/storage/r2/object_store.py - Cloudflare Runtime
src/pulse/infrastructure/cloudflare/workflow.py
Other components
- Show Operator
- X API
- Anthropic
- Voyage AI
- ElevenLabs
- Podcast Client
Connections 29
- Show Operator → Pulse CLI: configures and runs
README.md - Pulse CLI → Show Manager: manages shows
src/pulse/cli/main.py - Pulse CLI → Pipeline Manager: manages pipelines
src/pulse/cli/main.py - Pulse CLI → Schedule Manager: manages schedules
src/pulse/cli/main.py - Pulse CLI → Run Manager: runs manually
README.md - Show Manager → D1 Repositories: persists show
- Pipeline Manager → D1 Repositories: persists pipeline
src/pulse/application/configuration/pipeline_manager.py - Schedule Manager → D1 Repositories: persists schedule
- Schedule Manager → Run Manager: dispatches scheduled run
- Cloudflare Runtime → Run Manager: triggers workflow
README.md - Run Manager → Workflow Orchestrator: starts or resumes
src/pulse/application/execution/run_manager.py - Workflow Orchestrator → X Retrieval: retrieves conversations
README.md - Workflow Orchestrator → Signal Ingestion: deduplicates signals
README.md - Workflow Orchestrator → Signal Processing: filters and scores
README.md - Workflow Orchestrator → Theme Grouping: groups themes
README.md - Workflow Orchestrator → Episode Planning: plans episode
README.md - Workflow Orchestrator → Script Generation: writes episode
README.md - Workflow Orchestrator → Audio Production: generates speech
README.md - Workflow Orchestrator → Podcast Publishing: publishes episode
README.md - X Retrieval → X API: retrieves posts
README.md - Episode Planning → Anthropic: uses language model
README.md - Script Generation → Anthropic: uses language model
README.md - Signal Processing → Voyage AI: embeds signals
README.md - Audio Production → ElevenLabs: synthesizes speech
README.md - Podcast Publishing → R2 Object Store: stores feed and audio
README.md - Podcast Client → R2 Object Store: consumes public feed
README.md - Workflow Orchestrator → Cloudflare D1: checkpoints runs
README.md - Workflow Orchestrator → Vectorize Store: uses semantic history
README.md - D1 Repositories → Cloudflare D1: queries and writes
src/pulse/infrastructure/db/repositories/pipeline.py