[Try it Now] [简体中文] [日本語]

Easily find and export your Telegram messages with powerful semantic search, supporting all languages and unsegmented sentences.

Make message retrieval fast, accurate, and privacy-friendly — self-host or try online.

• Export to PostgreSQL or in-browser database (PGlite)
• Universal export format for easy import to any database
• One-click export to CSV / JSON

• Keyword search: multi-language support (Chinese, English, etc.)
• Natural language search: find messages like asking a question
• Smart filters: by contact/group, time range, with attachments, etc.

• Incremental sync: sync while using
• Storage options: server (PostgreSQL + pgvector) or browser-only mode (PGlite)
• Resume from breakpoint: auto-continue after failure

• Ask AI about your chats: query current chat or selected range
• AI message summary: auto-extract key points, todos, conclusions
• AI-powered search: natural language queries with pinpointed results
• AI chat: converse with AI based on your chat context
• AI analysis: trends, sentiment, keywords, insights from links & files
• Local model support: local Embedding / inference (no cloud required)

• Deep indexing for links & images: web summaries, image OCR/descriptions
• Attachment content extraction: PDFs, images, audio/video key frames & text

• Multi-client support: Discord, etc.

We provide an online version where you can experience all features of Telegram Search without self-deployment.

Visit: https://search.lingogram.app

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

Then open http://localhost:3333 🎉

docker run -d --name telegram-search \
  -p 3333:3333 \
  -v telegram-search-data:/app/data \
  -e TELEGRAM_API_ID=611335 \
  -e TELEGRAM_API_HASH=d524b414d21f4d37f08684c1df41ac9c \
  -e DATABASE_TYPE=postgres \
  -e DATABASE_URL=postgresql://<postgres-host>:5432/postgres \
  -e EMBEDDING_API_KEY=sk-xxxx \
  -e EMBEDDING_BASE_URL=https://api.openai.com/v1 \
  ghcr.io/groupultra/telegram-search:latest

1. Clone repository.

2. Run docker compose to start all services including the database:

docker compose up -d

3. Access http://localhost:3333 to open the search interface.

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

git clone https://github.com/groupultra/telegram-search.git
cd telegram-search
pnpm install
cp config/config.example.yaml config/config.yaml

# Start database (Docker)
docker compose up -d pgvector

# Start backend & frontend
pnpm run server:dev  # Terminal 1
pnpm run web:dev     # Terminal 2

📖 More development details: CONTRIBUTING.md

This project is a monorepo with event-driven architecture:

• apps/web: Vue 3 frontend
• apps/server: WebSocket server
• packages/client: Client adapters & stores (Pinia)
• packages/core: Event bus (EventEmitter3), services, database models (Drizzle ORM)
• packages/common: Logger & utilities

Key Technologies:

• Event-driven with CoreContext (EventEmitter3)
• Real-time communication via WebSocket
• PostgreSQL + pgvector OR PGlite (in-browser)
• Message processing pipeline: Embedding, Jieba, Link, Media, User resolvers

📖 Full architecture details, event flow, and diagrams: CONTRIBUTING.md