Documentation

Complete guide to using TeaL;DR, the AI-powered Discord search bot.

Introduction

TeaL;DR is a Discord bot that provides semantic search capabilities for your server's message history. Using advanced AI embeddings and natural language processing, TeaL;DR enables you to search through conversations using plain English queries, generate summaries, and gain insights from your server's data.

Key Features:

  • Semantic search using AI embeddings
  • Conversation summaries and recaps
  • Server analytics and statistics
  • Data export in multiple formats
  • Interactive features (quizzes, wrapped summaries)

How It Works

1. Message Indexing

TeaL;DR automatically indexes messages as they are sent in your server. Each message is processed through Google Gemini AI to generate semantic embeddings, which capture the meaning and context of the text.

2. Semantic Search

When you search using /ask, your query is converted into an embedding and compared against stored message embeddings using cosine similarity. This allows the bot to find relevant messages even if they don't contain exact keyword matches.

3. AI-Powered Responses

Retrieved messages are processed through an AI model to generate coherent summaries, answer questions, and provide context-aware responses. The bot maintains conversation history for follow-up questions.

4. Data Privacy

All server data is isolated and never shared between servers. Messages are automatically deleted after 30 days (configurable), and you can exclude specific channels from indexing at any time.

Quick Links

System Requirements

  • Discord Server: You must have administrator permissions or the "Manage Server" permission
  • Bot Permissions: Read Messages, Send Messages, Embed Links, Read Message History
  • Storage: Approximately 1MB per 1000 messages indexed

Need Help?

If you encounter any issues or have questions, check the troubleshooting guide or contact support.