StreamBuddy Docs

Everything you need to set up, configure, and troubleshoot your AI stream co-host — Base is free with an account, and this covers every feature start to finish.

🚀 1. Quick Start

Base is free, but every install still needs an account and a serial key. Get StreamBuddy talking to chat in five steps.

  1. Create a free account at modminds.site/streambuddy and claim your Base license from the Dashboard (or purchase Pro). Then activate StreamBuddy with your serial key on the Activate screen. Format: GB-XXXX-XXXX-XXXX-XX.
  2. Open Settings → AI Engine and choose Local (Ollama) or Cloud (Claude API). Local is recommended for first-time setup — the installer handles Ollama automatically.
  3. Open Connect and sign in to at least one platform — Twitch, Kick, or Velora.
  4. Open Settings → Voice, enable voice output, and pick a voice. A Microsoft Neural voice gives the best quality.
  5. Add the overlay URL as a Browser Source in OBS, then flip the Activate toggle on the Dashboard.
TIP Use the owner chat box at the bottom of the Dashboard to send the bot test messages before you go live — no need to type in real chat.
TIP Want more games, Soundboard, Stream Ads, Voice Input, or premium avatars? Purchase Pro from your Dashboard, then re-activate with your same serial key — no reinstall needed.

🧠 2. AI Engine

StreamBuddy supports two AI providers. Pick based on your hardware and budget.

Local — Ollama

Best forPrivacy, zero API cost, fully offline
RequiresOllama (auto-installed by the StreamBuddy installer)
Recommended modelllama3.2:3b — fast, good quality, low RAM
Default URLhttp://localhost:11434
NOTE The first response after launch is slow (model cold-start). Wait for the green AI status indicator on the Dashboard before going live — replies after that are fast.
TIP Keep Max Response Length around 80–120 tokens. Shorter replies feel snappy in chat; longer ones read like essays out loud.

Cloud — Claude API

Best forHigher-quality responses, no GPU required
RequiresAn Anthropic API key from console.anthropic.com
Recommended modelClaude Haiku 4.5 — fastest and cheapest for live chat
TIP Set Response Rate to 20–40% on busy channels to control API spend. At 100% on an active stream, credits disappear fast.

Hardware Auto-Detect

Settings can scan your GPU/RAM and suggest the fastest Ollama model that fits your VRAM budget, then download it for you with one click.

🔊 3. Voice & Audio

Three voice types are available, each with different audio routing.

Windows Voices (SAPI)

Built into Windows — robotic/classic TTS, no setup needed. Audio plays through your default speakers; OBS picks it up via desktop audio capture. No OBS overlay required.

Microsoft Neural Voices

High quality, natural-sounding. Uses Microsoft Edge's speech API (requires internet) and plays inside the OBS browser source as its own audio track. Examples: en-US-ChristopherNeural, en-US-JennyNeural.

NOTE In OBS, right-click the browser source → Properties → check "Control audio via OBS". Skip this and the voice synthesizes fine but you won't hear it.

Speed & Chat TTS

Recommended speech speed is 1.0x–1.2x. Above 1.3x sounds rushed; below 0.9x feels unnatural live. Chat TTS (reading chat messages aloud) can use its own separate voice and speed from the AI's response voice, and supports a word/phrase block-list so nothing inappropriate gets read on stream.

Voice Input PRO

Talk to StreamBuddy live on stream and hear it respond in real time, powered by local Whisper transcription. Two modes are available in Settings → Voice Input:

  • Keyword mode — StreamBuddy only responds when it hears a trigger word at the start of your sentence (e.g. "Hey Buddy, what do you think of this boss?"). Everything else is ignored.
  • Always-On mode — every complete utterance gets processed and potentially answered. Better for open, conversational streams.
NOTE The first time you enable the microphone, StreamBuddy downloads the Whisper model (~145 MB). The app may look unresponsive for 1–2 minutes during this one-time download — that's normal.

🎥 4. OBS Overlay Setup

The overlay renders the StreamBuddy avatar and plays Neural/Edge voice audio. OBS captures it as a dedicated Browser Source.

  1. In OBS, click + under Sources → choose Browser Source.
  2. Set the URL from the Dashboard. Same PC as OBS: http://localhost:3847. Separate streaming PC: use the LAN IP address shown on the Dashboard instead. Set width 220, height 300.
  3. Uncheck "Shutdown source when not visible," check "Control audio via OBS", click OK.
  4. Position the source in a corner of your scene or its own layer — background is transparent.
  5. A "Browser" channel appears in the OBS Audio Mixer — use it to control the bot's voice volume independently from mic/game audio.
TIP StreamBuddy must be running for the overlay to load. Blank source in OBS = app isn't open, or port 3847 is blocked by your firewall. On dual-PC setups, allow port 3847 through Windows Firewall on the PC running StreamBuddy.

Games overlay: a second browser source at /games (e.g. http://localhost:3847/games) renders animated game visuals like Plinko and Coin Pusher.

🔗 5. Platform Connections & Bot Accounts

StreamBuddy reads and responds in chat across all three platforms simultaneously.

Twitch

OAuth sign-in from the Connect page — open your browser, approve, done. No password is ever shared, only chat read/write permission. If the connection drops, disconnect and sign in again from Connect.

Kick

OAuth sign-in from the Connect page. Kick read access works over a public WebSocket; posting AI replies back to Kick chat requires the OAuth connection to be authorized.

Velora

OAuth (PKCE flow) — a browser window opens for login, tokens are stored locally and auto-refresh. You only need to sign in once.

Posting as a Bot Account

Each platform's connection card has an optional "Post chat replies as a bot" section — turn it on so StreamBuddy's chat text posts under a different name than your own streamer account, instead of coming from you.

Twitch / KickSign in with a genuinely separate account you own — same OAuth popup, just log into the bot account's own login
VeloraNo second account at all — pick or create a bot identity owned by your own Velora account, with its own name and a real uploaded avatar image

For Velora, click Set Up a Bot on the Connect page. It lists any bots you already own first — pick one, or create a new one with a name (checked live for availability) and an optional avatar.

TIP Disconnecting a Velora bot only clears the local selection in StreamBuddy — the bot itself keeps existing on your Velora account and can be reselected anytime.
NOTE Twitch/Kick bot accounts will likely need moderator access on your channel for their posts to be accepted — grant that from the platform's own moderator settings.

🎭 6. Personality Tuning

This is the heart of making StreamBuddy feel like your co-host instead of a generic chatbot.

Bot Name & System Prompt

Give your co-host a name, then write a short system prompt describing its personality. Mention the streamer's name and game genre — specific prompts dramatically outperform generic ones.

You are StreamBuddy, a witty and hype AI co-host for [streamer name]'s
gaming stream. Keep replies under 2 sentences. Match the energy of the
chat. Never break character.

Response Style

  • Humor Level — Low / Medium / High
  • Behavior Mode — Reactive (only replies when triggered), Balanced (mix), Proactive (interjects often)
  • Language — English, Spanish, French, German, Portuguese, Japanese, Korean

Response Rate & Delay

Stream sizeRecommended response rate
Under 50 viewers30–60% — present without dominating
50–500 viewers10–25% — engaging without spamming
500+ viewersUse trigger words instead of a flat rate

Response Delay (0.5s–1.5s recommended) makes the bot feel like it's reading and thinking rather than instantly blasting a reply.

Trigger Words

When set, StreamBuddy only responds to messages containing one of these words — e.g. !buddy or @StreamBuddy. Leave empty to respond freely at the configured rate. Essential on high-traffic channels so the bot feels summoned rather than spammy.

Ignore Bot Accounts

Enable this to stop StreamBuddy replying to Nightbot, Moobot, and other chat bots — prevents bot-to-bot reply loops.

Replies in Chat

StreamBuddy can post its AI responses directly into chat as text, not just speak them aloud — viewers see the reply right in the feed. Live now on Twitch; Kick and Velora support is coming soon.

Chat Commands

Create custom !commands for your channel from Settings → Chat Commands. Set a trigger word and define the response — static replies, countdowns, links, and more.

🎮 7. Games

Chat-playable mini-games StreamBuddy hosts directly in Twitch, Kick, and Velora chat.

Base Games — Free

GameCommandHow it works
Trivia!triviaAI generates a question — chat answers A/B/C/D
Number Guess!numguessGuess the number; bot gives hot/cold hints
Hangman!hangmanGuess letters with !g <letter>
Would You Rather!wyrAI generates 2 options, chat votes A or B
Poll!pollSet a question + 2–4 options; chat votes the letter, live vote bars on the overlay

Pro Games PRO

GameCommandHow it works
Speed Typer!speedtypeFirst to type the exact phrase wins
Emoji Decode!emojidecodeDecode an emoji puzzle with !g <answer>
Fast Math!fastmathFirst correct answer wins, 5 rounds
Plinko!dropDrop a ball — outer slots pay a 100pt jackpot, animated on overlay
Coin Pusher!pushFill the platform for a cascade payout, animated on overlay
Boss Battle!boss / !attackA random boss appears each fight; chat attacks together to bring down its HP bar for a shared coin payout
Story Chain!story / !addChat writes a story together a few words at a time — no winner, everyone who contributes earns points

Gameshow Mode PRO

The AI runs a full automated gameshow — picks games, hypes chat between rounds in a host personality you choose (Hype Host, Chill Vibes, Roast Master, Sports Caster, Chaos Goblin, or a custom prompt), and crowns a champion at the end. Configure show duration, break length between games, and which games are in rotation.

Leaderboard

Tracks score and wins per player across two views: This Session (resets when you reset it or restart) and All-Time (persists across streams). Both can be cleared independently from the Games page.

🪙 8. Chat Economy — Points, Fishing & Slots

Free. Runs in the background any time, independent of whatever round-based game is active. All off by default — turn them on in Settings → Chat Economy.

Passive Chat Points

Viewers earn coins just for chatting — configurable coins-per-message and a per-viewer cooldown so it can't be farmed by spamming.

Fishing — !fish

Chat casts a line with !fish. Loot ranges from junk (an old boot, 1 coin) to legendary catches worth up to 200 coins — roughly 1 in 7 casts comes up empty. !tackle shows a viewer's catch history, !coins shows their balance.

Click the ⚙ gear on the Fishing card (Games page) to fully customize the catch pool: toggle any built-in fish on/off, rename or reskin it, adjust its coin value within its rarity's range, or add your own custom fish — pick a rarity and StreamBuddy fills in balanced catch odds automatically.

Slots — !slots

Chat wagers coins with !slots <amount>. Most spins post as plain chat text; jackpots and big wins get a voice shoutout and show on the Games overlay. Turn the whole command off in Settings → Chat Economy if you'd rather not have gambling on your channel.

🏷 9. Stream Labels

Free. Small customizable text overlays for the stats viewers actually look for.

AvailableLatest Follower, Follower Count, Latest Subscriber, Subscriber Count, Latest Cheer/Tip, Session Uptime, Death Counter
Per-platformFollower/subscriber/cheer labels are tracked separately per platform, not merged into one number
CustomizationEach label gets its own text template, font size, and color

Enable the labels you want on the Labels page, then add its overlay URL (/labels) as its own OBS Browser Source.

🔊 10. Soundboard PRO

Upload short audio clips, then have StreamBuddy play them automatically from chat keywords or platform events — or click one to fire it yourself, live.

Keyword triggersComma-separated keywords (e.g. sadge, oof, rip) mapped to a clip, with a per-trigger cooldown and optional mods-only restriction
Platform eventsSeparate cards for Twitch, Kick, and Velora to auto-play a sound on follows, subs, gifted subs, and raids
NOTE Twitch and Velora event triggers need EventSub/Events access granted through their Connect-page OAuth flow. Kick uses its own live event feed and needs no extra setup once connected.

📢 11. Stream Ads PRO

Run your own sponsor or product reads — text, voice, video/image, or any mix — on a repeating schedule or redeemable by chat for coins.

NameAlso what chat types to redeem it: !ad <name>
Repeat every (minutes)Leave blank/0 to disable auto-scheduling and only run on manual/chat redemption
Coin costLeave blank to make it not redeemable by chat at all — owner/manual play only
NOTE Video/image ads need the Stream Ads overlay browser source added in OBS — text/voice-only ads don't need it.

⌨ 12. Commands & Automation

Free. Build your own chat commands, greetings, and recurring posts from the Commands page — no config files.

Custom Commands

Set a trigger (e.g. !discord), a response using {'{user}'}/{'{count}'} placeholders, a cooldown, mods-only or anyone, and whether it's spoken aloud or chat-text only. Works any time — never blocked by a round-based game.

Automated Events

Greet chatters automatically the first time they show up each session — no command needed. Pick who counts: anyone (new chatter), VIP, subscriber, moderator, or one specific username.

Timed Posts

A fixed message posted on a repeating interval — a Discord link, a donation reminder — independent of the chat-reply toggles.

📣 13. Shoutout

Free, built-in — always on, no settings toggle needed.

Mods and the streamer type !shoutout username or !so username to shout out another channel. It shows a timed box on the Ads overlay, tinted to the platform it was triggered from — purple for Twitch, green for Kick, gold for Velora — and posts a channel link back into that same chat only, never broadcast to every connected platform.

Rich infoTwitch always looks up an avatar + live category; Kick does on a best-effort basis; Velora shows username + a best-guess link only
Cooldown10 seconds
CustomizationA "Shoutout Box" card on the Commands page lets you resize the overlay box, edit the chat message template, and optionally have it spoken aloud too

🎁 14. Chat Giveaway

Free. A trigger-word entry giveaway, run from a card on the Games page.

  1. Pick a trigger word (e.g. !enter) and a scope — all connected platforms, or just one.
  2. Chat types the word once to enter. A duplicate entry from the same person on the same platform doesn't count twice.
  3. Hit Draw Winner whenever you're ready — entirely manual, no timer.

The Games overlay shows a live entry counter and, on draw, cycles the name through entrants before landing on the real winner with a confetti burst.

NOTE Scoped to "All Platforms," the same person entering from two different platforms counts as two separate entries — StreamBuddy has no way to know they're the same human across platforms.

⚙ 15. Settings Reference

Quick reference for every settings area.

  • Appearance — Dark/Light theme, font size, Streamer Mode (hides API keys, serials, and usernames on stream)
  • Colors — UI accent color, chat overlay background, chat text color
  • Voice — voice selection (searchable, filterable by language), speech speed, test playback
  • Chat TTS — separate voice/speed for reading chat aloud, plus a blocked-word filter
  • Avatar & Overlay — 14 avatar styles total (Stream Buddy, Vox, Ghost, and a Custom GIF/PNG upload free; 10 more unlock on Pro), overlay URL for OBS, LAN URL for dual-PC setups
TIP Settings only apply after you click Save. The voice test button always plays whatever is currently selected on screen, even unsaved — but live chat responses use the last saved settings.

✅ 16. Best Practices

  • Test before going live — send the bot a few messages from the Dashboard chat box and confirm the AI responds and voice plays.
  • Save settings first — live responses use saved settings, not whatever is currently on screen.
  • Give Ollama 30–60 seconds to warm up after launch — wait for the green AI indicator.
  • Always keep the OBS overlay open for Neural/Edge voices — without it, audio falls back to playing through the app window.
  • Keep max tokens low (80–120) — a 400-token response takes 30+ seconds to speak and chat will have moved on.
  • Turn on "Ignore bot accounts" to prevent bot-to-bot reply loops with Nightbot/Moobot.
  • Use the system prompt as your content filter — e.g. "Never discuss politics, religion, or controversial topics."
  • Connect multiple platforms freely — StreamBuddy reads and responds across all connected platforms at once.
  • Pace yourself through the feature set — you don't need Soundboard, Stream Ads, Boss Battle, and External Control on day one. Start with AI chat plus one game, then layer features in as you and your chat get comfortable.

🛠 17. Troubleshooting

AI is not responding

Check the Dashboard AI status indicator. "Starting…" means Ollama is still loading — give it a minute. If it stays yellow, verify the Ollama URL in Settings (http://localhost:11434) or switch to Cloud (Claude API) to isolate the issue.

Voice plays the default Windows voice instead of Neural

Check the Logs tab on the Dashboard for "Neural TTS: synthesis failed" — usually a connectivity issue reaching the Edge TTS API. Also confirm you selected a voice and clicked Save Settings before testing.

No audio through OBS

Right-click the browser source → Properties → confirm "Control audio via OBS" is checked, and that the Audio Mixer shows a "Browser" channel with its volume up.

Overlay shows blank in OBS

StreamBuddy must be running before OBS loads the source — close and reopen the browser source after starting the app. Confirm port 3847 isn't blocked by Windows Firewall.

Bot responds too much / too little

Adjust Response Rate in Personality. On busy channels, switch to trigger words so the bot only replies when directly addressed. Confirm "Ignore bot accounts" is on.

Twitch connection fails

Disconnect and sign in again from the Connect page to refresh your OAuth grant — Twitch tokens can expire or be revoked.

Serial won't activate

Double-check the format: GB-XXXX-XXXX-XXXX-XX. Each key allows up to 3 activations — if you've reinstalled multiple times, contact support to reset your activation count. This applies to Base too — every install needs an account and an active license (free for Base, paid for Pro) before its serial will activate.

Velora bot won't create or select

Your main Velora account must be connected first — the bot section stays inactive until it is. If it still fails, the Velora developer app likely needs the bot:write scope added on our end; if this keeps happening, let us know on Discord.

!shoutout / !so or the giveaway isn't working

Shoutout only responds to mods and the streamer — a regular viewer typing it is ignored by design, and there's a 10-second cooldown between uses. For giveaways, double-check the platform you're testing from matches the giveaway's configured scope (All Platforms vs. one specific one).

Still stuck? Email support@modminds.site or open a ticket below.

❓ 18. FAQ

Base is free with an account — claim it from your Dashboard, no payment needed — and includes live chat reading across all three platforms, 400+ AI voices, the animated overlay with 4 avatars (including a custom GIF/PNG upload), 5 chat games, the full chat economy (points/fishing/slots), unlimited custom commands, Stream Labels, Shoutout, and Chat Giveaways. Pro adds 7 more games plus Gameshow Mode, mic voice input, Soundboard, Stream Ads, 10 additional premium avatars, and priority support.

Yes. Windows SAPI voices play through your system speakers and don't need an overlay at all. Neural/Edge voices and the avatar visual do require an OBS Browser Source to work properly during a stream.

Yes — every install needs a free account at modminds.site/streambuddy and a serial key, even for Base. Claim your Base license from the Dashboard at no cost, then activate with the serial key that comes with your account. Each key supports up to 3 activations so you can move between a streaming PC and a backup machine.

Mostly. The Local (Ollama) AI engine runs fully offline once the model is downloaded. License re-validation and Neural/Edge voices need an internet connection; Windows SAPI voices do not.

Need a human instead?

Join the Discord for free community help, or pick up a paid support plan for guaranteed response times and live 1-on-1 sessions.

We use cookies to keep you logged in, analyse site traffic, and power live chat support. Some are essential — others need your permission. See our Privacy Policy.

Cookie Preferences

Your choice is saved for 1 year and can be updated at any time.

Strictly Necessary
Login sessions, CSRF security tokens, and core site functionality. Always active — cannot be disabled.
Analytics
Google Analytics 4 helps us understand how visitors use the site so we can improve it. No data is shared with advertisers.
Live Chat & Support
Enables the Live Helper Chat widget so you can reach our support team directly from any page.