Skip to content

StreamBuzz is an AI-powered multi-agent tool built to simplify live streaming by acting as a YouTube Live Stream Chat Moderator.

Notifications You must be signed in to change notification settings

hammaadworks/streambuzz

Repository files navigation

StreamBuzz πŸš€


πŸ† We Won the Live Agent Studio Hackathon! πŸŽ‰

Exciting news! StreamBuzz is now officially a part of Live Agent Studio after winning the oTTomator Live Agent Studio Hackathon! πŸ…πŸš€

You can try out StreamBuzz here and experience AI-powered chat moderation in action.



A huge thanks to the oTTomator team, the amazing global streamer community, and everyone who voted and supported this project! ❀️


Index

  1. Intro
  2. Why StreamBuzz?
  3. Getting Started
  4. How to Contribute
  5. Roadmap
  6. Demo & Architecture
  7. Acknowledgments

Your AI-powered YouTube Live Stream Chat Moderator

Attention Streamers!!

Tired of drowning in a tsunami of chat messages while trying to present to your audience? StreamBuzz to the rescue! This AI sidekick filters key messages, handles FAQs, and posts repliesβ€”so you can focus on being the rockstar streamer you were born to be.


Why StreamBuzz?

Live streaming is booming, with over 2 billion monthly YouTube users. Streamers educate, entertain, and engage, but juggling an avalanche of chat messages while presenting is like trying to play chess on a roller coaster. 🎒 Important questions, concerns, and requests get lost in the flood, making chat management feel impossible.

The Solution

StreamBuzz filters the noise, highlights key messages, and automates replies, so you can engage without stress. No more hunting through chat chaosβ€”just smooth sailing! β›΅


StreamBuzz Features
StreamBuzz Features


StreamBuzz Demo
Click the thumbnail to watch the demo on YouTube! πŸš€


Meme Break #1 πŸ˜†


Balloons Meme 1


Usage

  1. Go to Live Agent Studio to try StreamBuzz
  2. Pick a YouTube Live Stream and send it to StreamBuzz, to get started.
  3. StreamBuzz filters and prioritizes chat messages (buzz) in the background.
    • StreamBuzz intelligently processes multilingual chats, too.
  4. Navigate through the real-time buzz list using natural language.
    • With sentences like, get current buzz or get next buzz.
  5. Post replies directly from the chat interfaceβ€”error-free and neatly summarized.
    • StreamBuzz background worker takes care of correcting typos, summarizing and posting your replies.
  6. Upload a text file to build a knowledge base and supercharge your responses. ⚑️

All in all, StreamBuzz is the ultimate companion and chat moderator to supercharge your YouTube Live Streaming experience.


Benefits

🎯 Focus on Content – Let StreamBuzz handle chat while you do your thing.
πŸ” Better Engagement – Important questions, concerns, and requests stand out.
⏳ Saves Time – Generates replies for buzz (important messages), reducing your mental load.
πŸ› οΈ Customizable – Update your knowledge base, and StreamBuzz adapts automatically.
πŸ’¬ Improves Viewer Experience – Ensures timely, relevant, typo-free responses.


Features

πŸ”Ή AI Chat Moderation – Extracts key messages (buzz) from an ocean of chat spam. Navigate buzz at your own pace.
πŸ”Ή Suggested Replies – Auto-generates responses and allows customization via a text-based knowledge base.
πŸ”Ή RAG (Retrieval-Augmented Generation) – Smarter responses for streamers and chat queries.
πŸ”Ή Seamless YouTube Integration – Works directly with YouTube Live Chat in real time.


Meme Break #2 πŸ˜†


Advice Meme 2


Getting Started

Clone

# Clone the repository
git clone https://github.com/hammaadworks/streambuzz.git
cd streambuzz

# Create a virtual environment (optional)
python -m venv .venv
source ./.venv/bin/activate

# Install dependencies
pip install -Ur requirements.txt

Configure

  1. Fill in your keys as specified in the .env.example file.
    • Use your model of choice by changing variables in constants.py under model section.
    • Paste your YouTube credentials in .env file as specified in .env.example file.
  2. Create database tables using the DDL commands provided in queries.sql file.
  3. Set up the user interface using Agent 0 by Ottomator.ai (Agent 0).

Run

  1. Set Environment Variable in .env file

    # Copy .env.example to .env and set your keys in .env file
    cp .env.example .env
  2. Serve the FastAPI app

    fastapi-cli dev streambuzz.py --port 8001 --reload

    Alternatively, you can use uvicorn:

    uvicorn streambuzz:app --host 0.0.0.0 --port 8001

How to Contribute

We welcome contributions from the community! If you'd like to improve StreamBuzz, follow these steps:

  1. Fork the Repository – Start by forking the repo and creating a local clone.
  2. Create a New Branch – Work on a feature or bug fix in a dedicated branch.
  3. Submit a Pull Request – Once you're happy with your changes, open a PR with a clear description.
  4. Review & Merge – Your PR will be reviewed, and if all looks good, it'll be merged into the main branch.

Ways to Contribute

  • Report bugs or suggest new features by opening an issue.
  • Improve documentation to help others get started easily.
  • Enhance the AI model to make chat moderation even smarter.
  • Add new integrations or performance improvements.

Let's build a better streaming experience together! πŸš€


Project Roadmap

Next up: More features, fewer bugs, full throttle! πŸš€

  1. Expanded YouTube Live URL Support

    • Priority: High
    • Effort Estimate: XS
    • Detail:
      • YouTube has multiple URL formats for the same live stream.
      • Currently supports: youtube.com/watch?v=<video_id>
      • Need to extend validation to support multiple YouTube Live URL formats beyond youtube.com/watch?v=<video_id>.
      • Ensures seamless moderation across different YouTube link variations.
  2. Enhanced Buzz Navigation

    • Priority: Medium
    • Effort Estimate: S
    • Detail:
      • Currently, only forward navigation is supported.
      • Add support for reviewing and navigating previous buzz messages.
      • Implement shorthand navigation via <, =, > symbols for faster access.
  3. Multi-File RAG Support

    • Priority: Medium
    • Effort Estimate: S
    • Detail:
      • Only one text file can be uploaded per session.
      • Extend support for multiple files and diverse formats.
      • Allow multiple files of different formats to be uploaded per session.
  4. Live Chat Reply for Subscriber-Only Streams

    • Priority: High
    • Effort Estimate: M
    • Detail:
      • StreamBuzz cannot post replies if the stream requires subscribers-only chat.
      • Implement an auto-subscribe feature so StreamBuzz can participate in subscriber-only chats where moderation is currently restricted.
  5. OAuth Integration

    • Priority: High
    • Effort Estimate: L
    • Detail:
      • Currently, replies are posted via the StreamBuzz Bot account.
      • Implement Google OAuth to allow streamers to post replies from their own accounts instead of the StreamBuzz Bot.
      • Improves authenticity and compliance.
  6. Multi-Stream Moderation Per Session

    • Priority: Medium
    • Effort Estimate: L
    • Detail:
      • Currently, only one stream can be moderated per chat session.
      • Enable StreamBuzz to moderate multiple live streams simultaneously instead of being restricted to a single session.
  7. Multi-Platform Live Stream Support

    • Priority: Low
    • Effort Estimate: XL
    • Detail:
      • StreamBuzz is limited to YouTube Live.
      • Extend StreamBuzz beyond YouTube to support Twitch, Facebook Live, and other popular streaming platforms.

Meme Break #3 πŸ˜†


Drake Meme 3


Demo & Architecture

Images

1. Start chat moderation with ease.

Start Moderating

2. Navigate through chat messages effortlessly.

Buzz Navigation

3. Stay up to date with all key chats. πŸŽ‰

All Caught Up!

4. Seamless reply integration with YouTube Live Chat.

Live Reply Integration

5. Replies posted within a timeframe of 60 seconds on YouTube Live Chat.

YouTube Reply Posted

6. RAG powered responses

RAG Powered

Videos

1. StreamBuzz: Control Your Live Chat Like a Pro with AI! πŸš€πŸ”₯


2. StreamBuzz: AI-Powered Autocorrect & Smart Replies for Streamers! πŸš€πŸ”οΈ


3. StreamBuzz: Agentic RAG on Custom Knowledge πŸš€πŸŽ™οΈ


4. StreamBuzz: The Ultimate AI Chat Moderator for Live Streamers! πŸš€πŸ”₯️


Architecture Diagrams


StreamBuzz Architecture
StreamBuzz Architecture


Agent Crew
A Moderator Crew of 5 Agents to your rescue!


YouTube Channel & Playlist

Check out my YouTube channel for tutorials, updates, and behind-the-scenes content:
πŸ“Ί My YouTube Channel

I’ve also put together a playlist showcasing StreamBuzz in action:
▢️ StreamBuzz Playlist


Acknowledgments

StreamBuzz was created as part of the oTTomator Live Agent Studio Hackathon.
Huge shoutout to Cole Medin and the Ottomator AI Team
for hosting this incredible event and pushing the boundaries of AI-powered automation! πŸŽ‰

A massive thank you to the open-source community for their contributions, making cutting-edge technology accessible to all.
Special appreciation for projects like Pydantic AI and others, your work makes innovations like StreamBuzz possible!

To all content creators who educate, share knowledge, and make resources more accessibleβ€”you are shaping the future!
Special mentions go to:

  • πŸŽ₯ Cole Medin – Breaking down AI, automation, and building cool stuff.
  • πŸŽ₯ Your Tech Bud Codes – Making tech & coding easier for everyone.

Special Thanks to the Global Streamer Community πŸŽ™οΈβœ¨

Most importantly, a heartfelt thanks to the global streamer communityβ€”the educators, entertainers, and innovators
who make live streaming a hub of knowledge and engagement.

You inspire us to build tools that make your work easier and your content even better.
This is for you! πŸš€


Hackathon Community Voting (Archived)

This section has been archived following the conclusion of the hackathon. Thank you for your support!

  1. 🌟 Visit Live Agent Studio to explore StreamBuzz and a ton of other incredible agents!
  2. 🎬 Try out StreamBuzz! Before diving in, please check out the usage section for the best experience, or simply watch the demo video to get a quick overview.
  3. βœ… Cast your vote for your favorite agentsβ€”I'm hoping that StreamBuzz is one of them! 🀩
  4. πŸ€— Thank you so much for your support! Your vote means a lot.

About

StreamBuzz is an AI-powered multi-agent tool built to simplify live streaming by acting as a YouTube Live Stream Chat Moderator.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published