Core Commands

Basic bot interaction and AI assistance commands.

!help

Display all available commands with a random meme.

!help

Response: Shows categorized command list. Admin users see additional admin-only commands.

!ping

Test if the bot is responsive.

!ping

Response: Pong! Bot is responsive. All systems operational.

!ai

Ask OpenAI GPT-4o-mini a question. Supports conversation continuity when replying to AI responses.

!ai <your question>

Examples:

!ai What is the capital of France?
!ai Explain quantum computing in simple terms

Features:

Must be used in a group chat (security requirement)
Rate limited to 20 requests per hour per user
Reply to an AI response to continue the conversation

Requirements: OPENAI_API_KEY environment variable

!lai

Ask the local AI (Irregularbot) a question. Uses self-hosted Open WebUI instance.

!lai <your question>

Examples:

!lai What are best practices for Signal group moderation?
!lai Summarize the key points of operational security

Requirements: LOCAL_AI_URL and LOCAL_AI_API_KEY environment variables

!summarize / !tldr

Summarize text, URLs, or video transcripts using AI.

!summarize <text or URL>
!tldr <text or URL>
!tldr                     (reply to a message with a URL)

Examples:

!summarize https://example.com/long-article
!tldr https://www.youtube.com/watch?v=dQw4w9WgXcQ
!tldr https://www.instagram.com/reel/ABC123/
!tldr This is a very long piece of text that needs summarizing...

Features:

Automatically detects URLs and scrapes content
Strips unnecessary HTML, keeps main content
Works with plain text, web pages, PDFs, and videos
Reply mode: Reply to any message containing a URL with !tldr to summarize it
Fallback: Provides bypass/archive links if scraping fails or content is paywalled

Video Transcript Summarization

!tldr supports video URLs from multiple platforms. The bot extracts the transcript and generates an AI summary with key points and notable quotes.

Platform	Content Types	Transcript Method
YouTube	Videos, Shorts	Auto-captions, manual captions, caption API, or Whisper
Instagram	Reels, IGTV	Whisper audio transcription
TikTok	Videos	Whisper audio transcription
Facebook	Videos, Reels	Whisper audio transcription

How it works:

YouTube uses a 4-tier fallback chain: yt-dlp auto-subtitles → manual subtitles → caption API → Whisper transcription
Instagram/TikTok/Facebook go directly to Whisper (these platforms don’t have captions)
Transcripts are cached in the database to avoid re-fetching on repeated requests
AI summarization uses Community AI (preferred) with OpenAI fallback

Limitations:

Whisper transcription requires audio download + CPU processing (may take 30-60 seconds)
Private or age-restricted videos cannot be accessed
Very long videos (>2 hours) may be truncated
Rate limited: 20 summarizations per hour per user

!zeroeth

Display the Zeroeth Law and community guidelines.

!zeroeth

Response: Shows community rules including:

No illegal activity
No violence or threats
Respect privacy
Keep content appropriate
Follow Signal ToS

!cleaner

Clean URLs of tracking parameters and provide paywall bypass/archive links.

!cleaner <url>

Example:

!cleaner https://www.nytimes.com/article?utm_source=twitter

Response:

Returns the cleaned URL (tracking params removed)
Provides archive links (Archive.today, Wayback Machine, GhostArchive)
Provides bypass links (Smry.ai, RemovePaywall, Archive.ph)

Features:

Removes utm_, fbclid, gclid, and other tracking parameters
Checks validity of the URL
Generates multiple bypass/archive options automatically