Documentation

Complete guide to using Alesha AI for your live streams

Getting Started

Alesha is an AI co-host for your live streams. The bot reads chat, engages viewers in 30+ languages, translates messages, moderates toxicity, and helps grow your channel. Everything is managed from the web dashboard.

Quick Start (3 minutes)

1

Sign in with Google

Click 'Get Started Free' and sign in with your Google account at aleshaai.com

2

Connect a platform

In the dashboard, connect YouTube (free). Twitch and Kick require Pro. For Twitch, Alesha adds itself as a moderator automatically — nothing to set up.

3

Turn the bot ON

Flip the switch in Bot & Platforms and start streaming. Alesha joins your chat automatically.

Set up the FREE plan (super simple)

Free Alesha is ad-supported. Do these once and the bot runs:

  1. 1Under the bot switch, tick the box — you agree to occasional clearly-labeled sponsor messages in your chat.
  2. 2Pick your SmartLink name — one short word (e.g. your channel name). You get https://aleshaai.com/st/yourword. You can't change it later, so choose well.
  3. 3Press Copy. It copies one whole line: My links & sponsors: https://aleshaai.com/st/yourword
  4. 4Open your CHANNEL description — the About page of your channel, NOT a video's description. YouTube: Customize channel → Basic info → Description. Twitch/Kick: your channel About / bio.
  5. 5Paste that whole line into the description and Save.
  6. 6Back in Alesha, press 'I've added it — check'. When it turns green, flip the bot ON and go live. Done!

✅ This does not affect your own channel monetization — your YouTube ads, memberships, Super Chats and your own sponsorships stay 100% yours.

Supported Platforms

YouTube

  • Full integration: AI replies in chat
  • Message translation (30+ languages)
  • Moderation (delete + timeout)
  • Super Chat / membership thanks
  • Viewer loyalty & analytics
  • YouTube comment replies (videos, Shorts, community posts)

Twitch

  • Full integration: AI replies in chat (via @alesha_ai_bot)
  • Bot auto-modded on connect — no manual setup (same one-click flow as Nightbot)
  • Message translation
  • Moderation (delete + timeout)
  • Bits & subscription thanks
  • Raid detection
  • OAuth + dedicated bot account model

Kick

  • Full integration: AI replies in chat
  • Message translation
  • Moderation (delete + timeout)
  • Gift & subscription thanks
  • Webhook integration
  • OAuth 2.1 + PKCE

Dashboard

The dashboard at aleshaai.com/dashboard is your control center. Sign in with Google to access it.

Bot status — operational state at a glance: 'Listening LIVE on YouTube + Twitch', 'No platforms connected', or 'Reconnect needed' (not just ON/OFF)
Platform connections (YouTube, Twitch, Kick) with LIVE status badges that auto-update every 30 seconds
Quota usage with progress bar — turns amber at 80%, red at 95%, with explicit 'X replies left' warning
Stream analytics (messages, viewers, languages, engagement score)
Follower growth chart — track subs/followers across platforms over time
Bot persona settings (name, gender) + Custom AI persona
AI replies toggle + Translation toggle — with combined behavior matrix
YouTube Comment Replies panel — toggle ON/OFF, see replies, daily counter
Live polls and trivia controls
Real-time notifications (mood shifts, stream summaries, plan warnings)
Custom chat commands
AI moderation + custom blocked words
Social links — preset platforms + custom links (Website, Merch, Patreon, etc.)
Donation goals with progress bar and milestone celebrations
AI Voice Chat with OBS/Prism overlay — 9 voices, URL expires every 7 days
Top viewers — relationship badges (🔥 Active in last 24h, ⚠ At risk if not seen in 7+ days), streams attended count
Stream history with platform badges
Moderation log — full message body shown, the trigger keyword highlighted in amber so you see at a glance which word fired
Subscription management — upgrade, cancel at end of billing period

Key Features

GPT-powered bot generates context-aware replies, considering the last 12 messages. Replies in the viewer's language, supports 30+ languages, adapts reply frequency to chat speed. Loyal/VIP viewers get priority replies. How the AI Replies and Translation toggles work together: • AI Replies ON + Translation ON → replies to everyone, translates foreign messages • AI Replies OFF + Translation ON → silent for regular chat, but still replies to foreign viewers and @mentions • AI Replies ON + Translation OFF → replies to everyone, no translations • AI Replies OFF + Translation OFF → fully silent, only @mentions get a response

Use your own YouTube quota (BYOK)

Advanced / technical, one-time (~10 min). By default your channel runs on our shared quota; once your own key is set up, Alesha automatically switches your channel to YOUR Google Cloud quota the moment the shared one runs out — so you never go dark. Best for high-volume streamers.

1

Open console.cloud.google.com and create a new project (e.g. "My Alesha Bot").

2

APIs & Services → Library → search "YouTube Data API v3" → Enable.

3

APIs & Services → OAuth consent screen → External → set an app name + your email → under "Test users" add the EXACT Gmail you sign in to Alesha with (your YouTube channel's account). It can be different from the project's email — but if it isn't in this list, the connect fails with "access_denied".

4

APIs & Services → Credentials → Create credentials → OAuth client ID → Application type: Web application.

5

IMPORTANT — under "Authorized redirect URIs" add EXACTLY https://api.aleshaai.com/oauth2callback (skipping this is the #1 cause of a redirect_uri_mismatch error).

6

Click Create, then copy your Client ID and Client secret.

7

Dashboard → Settings → Advanced → "Use your own YouTube quota" → paste both → "1. Save keys" → "2. Connect YouTube with my key".

In Testing mode the token can expire after ~7 days — if Alesha asks you to reconnect, click "Connect YouTube with my key" again. To make it permanent, click "Publish app" on the OAuth consent screen.

Plans

FeatureAd-supported · $0Pro · Ad-free · $12.99/mo
YouTube live chat
Twitch live chat
Kick live chat
Real-time chat translation (30+ languages)
Unlimited AI replies
Custom commands (!points, !so…)
AI moderation
Custom blocked words
YouTube comment replies + moderation
Full analytics + follower growth
Social links + custom links promos
Custom AI persona
AI Voice Chat (TTS, 9 voices)
Priority support
No Alesha promo in chat

Pay with Stripe (card). Stripe: subscriptions auto-renew monthly. Cancel anytime — you keep your plan until the end of the billing period. If renewal fails, you'll be notified.

FAQ

Still have questions?