🎙️ Ellipsis — One Click. Infinite Conversations.

A next-gen podcast generation agent that brings human-like, high-quality audio content to life—on any topic, with just one click. Whether it’s breaking news, deep-dive tech explainers, movie reviews, or post-match sports breakdowns, ellipsis crafts intelligent podcast episodes that sound like they were created by seasoned hosts in a professional studio.

Table of Contents

• Introduction

• Feature Comparison

• Example Usecases

• Tech Stack

• Prerequisites

• Configuration

• Installation

• Usage

  • Content Generation
  • Streaming Updates (SSE)
  • Trending Topics
  • Podbean Publishing
  • Cancellation

• License

• Contact

---

Introduction

🚀 What Makes ellipsis Unique?

• 🧠 Intelligent Multi-Speaker Dialogue
  Automatically generates natural, engaging conversations with multiple distinct voices and personalities.

• 📚 Covers Everything
  From LLM architectures to lunar eclipses, ellipsis understands the depth and nuance of any topic.

• ✅ Custom Evaluation Engine
  Each episode is passed through rigorous evaluation pipelines to ensure:

  • Factual accuracy 🧾
  • Legal and ethical soundness ⚖️
  • High conversational quality 🎧

---

Feature Comparison

Feature	Ellipsis	NotebookLM	NoteGPT
🎙️ Podcast Generation	✅ fully automated	✅ fully automated	✅ fully automated
🧠 Multi-Speaker Support	✅ Multiple distinct voices	❌ Two-speaker conversations	✅ Multiple distinct voices
📚 Topic Versatility	✅ Covers news, tech, movies, sports, etc.	⚠️ No web search capability yet	⚠️ Limited to provided notebook context
✅ Factual & Legal Evaluation	✅ Built-in evaluators for accuracy & legality	⚠️ Not Clearly specified	❌ No evaluation engine
🎧 Audio Output Quality	✅ Human-like, podcast-ready audio	✅ Human-like, podcast-ready audio	❌ Conversations at this point sound more robotic
🛠️ Custom Input formats	⚠️ Currently working on Documents	✅ Supports Documents, Video URLs etc	⚠️ Supports Documents but not other sources

Example Usecases

• Movie Reviews

thunderbolts_review.mp4

• Sports News

Nadal_retirement.mp4

Tech Stack

• Backend: Python, Flask, Redis (pub/sub), llama.cpp, Orpheus TTS
• Frontend: React, Vite, Tailwind CSS, Lucide Icons
• Integration: Perplexity API, Podbean MCP, Server-Sent Events (SSE)

Prerequisites

• Node.js v16+ and npm/yarn
• Python 3.10+ and pip
• Redis server running (default on localhost:6380)

Configuration

• Copy this to backend/.env and set:

  REDIS_URL=redis://localhost:6379
  PERPLEXITY_API_KEY=your_key_here
  PODBEAN_CLIENT_ID=...
  PODBEAN_CLIENT_SECRET=...

• Copy this to frontend/.env and set:

    # VCL: default set to localhost
    REACT_APP_API_URL=http://127.0.0.1:5000 

Installation

1. Clone the repo

   git clone https://github.com/dineshkannan010/Ellipsis.git
   cd Ellipsis

2. Backend setup

   cd backend
   python -m venv venv
   source venv/bin/activate    # macOS/Linux
   venv\Scripts\activate     # Windows
   pip install -r requirements.txt

   Install native & extra-index packages Some packages aren’t available on PyPI and must be pulled from alternate indexes or GitHub:

   # llama.cpp (CPU wheel)
    pip install llama-cpp-python \
    --extra-index-url https://abetlen.github.io/llama-cpp-python/whl/cpu
   
   # Orpheus TTS bindings
    pip install git+https://github.com/freddyaboulton/orpheus-cpp.git
   
   # HuggingFace XET backend
    pip install huggingface_hub[hf_xet] hf_xet
   

3. Frontend setup

   cd frontend
   npm install                # or yarn install

Usage

Content Generation

• Launch backend:

  cd backend
  python app.py

• Launch Redis Server

  redis-server --port 6380

• Launch frontend:

  cd frontend
  npm run dev                # or yarn dev

  • Launch Podbean Server

  cd backend/integrations/podbean_mcp
  pip install -e .
  python server.py
  

  • Launch Podbean Client

  cd backend/integrations/podbean_mcp
  python client.py server.py
  

• Enter a topic in the homepage textbox and hit Enter. Switch to the ContentGenerationView to see live script & audio progress.

Streaming Updates (SSE)

• The frontend subscribes to /stream via EventSource.
• Backend publishes events of types status, script, and audio.

Trending Topics

• Click Trending in the post box.
• Fetches /api/trending, which queries Perplexity with a custom prompt.

Podbean Publishing

• After audio is ready, enter a prompt like Post this podcast to Podbean.
• The client detects podbean intent and calls /api/podbean/publish via Beacon or fetch.

🙏 Acknowledgments

Huge thanks to amurshak for creating and maintaining the Podbean MCP Server.

License

MIT © Ellipsis

Contact

For questions or feedback, open an issue or reach out to

Dinesh Kannan

Lohith Senthilkumar

Parinita Das

Manideepika Myaka