README_EN.md

March 4, 2026 · View on GitHub

preview

groupultra%2Ftelegram-search | Trendshift

[Live Demo] [简体中文] [日本語]

Discord Telegram DeepWiki
GitHub Package Version Release Docker / OCI CI

Tip

Struggling to search Chinese, Japanese, or Korean (CJK) messages in Telegram?

Important messages often get lost in the noise — especially when word boundaries aren’t clear.

Telegram Search solves this with advanced semantic search and word segmentation, fully supporting CJK and all languages.

Vector search enables fuzzy, sentence-level matching, making it easy to find the information you need—even in languages without spaces.

💖 Sponsors

Sponsors

✅ Feature Highlights

📦 Export & Backup

  • Export chat history to multiple database types: supports both PGlite and PostgreSQL
  • Media files are automatically backed up to MinIO object storage—no manual steps required
  • Automatic vector embedding and tokenization during export for precise future search
  • Real-time sync keeps all conversations updated continuously
  • Intelligent word segmentation for accurate, multilingual retrieval
  • Combines fuzzy matching with vector-based semantic search for highly efficient results
  • Image semantic search: find images by text description via image embedding
  • Infinite scroll for search results — smoother browsing experience
  • RAG-powered AI Q&A: Chat with AI using your Telegram history as real-time context

🤖 Telegram Bot

  • Search and export messages via Bot
  • Message deep links — jump to the original conversation in one click

🚀 Advanced Features

  • Smart unread message summaries: Instantly aggregate all unread content with a concise AI-generated summary
  • Date range filtering for quickly narrowing down search results
  • Context menu to jump to the original Telegram message, with mobile support

🛣️ Roadmap

🧠 Enhanced AI Capabilities

  • Automatic session summaries
  • "Super Brain": Build knowledge graphs of people and events directly from your chat records
  • Intelligently organize your "Saved Messages" for efficient content management
  • Deep link and image indexing: web page summarization, OCR for images, AI-driven captions—powerful search & archival

🌐 Multi-platform Integration

  • Expand to Discord and other major social/messaging platforms for unified search and backup

🎉 Try It Now

We offer an online experience—no deployment needed. Try all Telegram Search features instantly.

Visit: https://search.lingogram.app

Warning

No cryptocurrency has been issued by us. Please beware of scams.

This tool exports only your own chat history. Do not use it for illegal purposes.

🚀 Quick Start

Deploy with Docker Compose

The recommended way to self-host is with Docker Compose. This launches the UI, backend, database, and media storage in one step.

  1. Create an empty folder for your Telegram Search data and config:
mkdir telegram-search
cd telegram-search
  1. Download the Docker Compose and default environment files:
curl -L https://raw.githubusercontent.com/groupultra/telegram-search/refs/heads/main/docker/docker-compose.yml -o docker-compose.yml
curl -L https://raw.githubusercontent.com/groupultra/telegram-search/refs/heads/main/docker/.env.example -o .env
curl -L https://raw.githubusercontent.com/groupultra/telegram-search/refs/heads/main/docker/init.sql -o init.sql
  1. Start all containers:
docker compose -f docker-compose.yml up -d
  1. Open http://localhost:3333 in your browser to start using Telegram Search! 🎉

Deploy with Docker Image

If MinIO is not configured, media files will be stored in the local data/media directory.

docker run -d --name telegram-search -p 3333:3333 ghcr.io/groupultra/telegram-search:latest

Environment Variables

Important

AI Embedding & LLM settings are now per-account in-app (Settings → API).

Please restart the service after modifying the .env file by running docker compose -f docker-compose.yml up -d.

All environment variables are optional. If not provided, the default values will be used.

VariableDescriptionExample
TELEGRAM_API_IDFrom my.telegram.org611335
TELEGRAM_API_HASHFrom my.telegram.orgd524b414d21f4d37f08684c1df41ac9c
DATABASE_TYPEDatabase type: postgres or pglitepglite
DATABASE_URLPostgreSQL connection string (DATABASE_TYPE=postgres only)postgresql://postgres:123456@pgvector:5432/postgres
TELEGRAM_BOT_TOKENBot token from @BotFather123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
PROXY_URLProxy address (formats like socks5://user:pass@host:port)socks5://user:pass@host:port
PORTBackend HTTP/WebSocket listening port3333
HOSTBackend listening address0.0.0.0
BACKEND_URLUpstream backend for Nginx /api//ws proxyhttp://127.0.0.1:3333
MINIO_URLMinIO service addresshttp://minio:9000
MINIO_ACCESS_KEYMinIO access keyminioadmin
MINIO_SECRET_KEYMinIO secret keyminioadmin
MINIO_BUCKETMinIO bucket nametelegram-media

Deploy with Docker Image

Please modify the environment variables according to your needs.

docker run -d --name telegram-search \
  -p 3333:3333 \
  -e TELEGRAM_API_ID=1234567890 \
  -e TELEGRAM_API_HASH=1234567890 \
  -e DATABASE_TYPE=postgres \
  -e DATABASE_URL=postgresql://postgres:123456@pgvector:5432/postgres \
  -e PROXY_URL=socks5://user:pass@host:port \
  -e PORT=3333 \
  -e HOST=0.0.0.0 \
  ghcr.io/groupultra/telegram-search:latest

💻 Development Guide

Browser-only Mode

git clone https://github.com/groupultra/telegram-search.git
cd telegram-search
pnpm install
cp .env.example .env
pnpm run dev

Server Mode

git clone https://github.com/groupultra/telegram-search.git
cd telegram-search
pnpm install

cp .env.example .env

docker compose up -d pgvector minio

pnpm run server:dev
pnpm run web:dev

📖 More details: CONTRIBUTING.md

🚀 Activity

Alt

Star History Chart