Telegram Search - Intelligent Chat History Search Tool

🔍 Project Overview

Telegram Search is a powerful Telegram chat history search tool that supports vector search and semantic matching. Powered by OpenAI's semantic vector technology, it makes your Telegram message retrieval smarter and more accurate.

✨ Key Features

• Intelligent Semantic Search: Understands the semantic meaning of messages based on OpenAI's vector technology.
• Vector Search: Utilizes advanced search algorithms to provide efficient search results.
• Chat History Backup: Easily back up your chat history.
• User-Friendly Interface: Simple and easy to use design.
• Cross-Platform Support: Supports multiple operating systems.
• Open Source & Free: MIT License, fully open source.

🚀 Quick Start

Environment Requirements

• Node.js
• pnpm
• Docker and Docker Compose

Installation Steps

1. Clone the Repository

git clone https://github.com/GramSearch/telegram-search.git
cd telegram-search

2. Install Dependencies

pnpm install

3. Configure Environment

cp config/config.example.yaml config/config.yaml

4. Start Database Container

docker compose up -d

5. Synchronize Database Table Structure

pnpm run db:migrate

6. Start the Service

# Start the backend service
pnpm run dev:server

# Start the frontend interface
pnpm run dev:frontend

7. Access the Application Open your browser and visit http://localhost:3333 to use the search interface.

🔧 Technical Architecture

Core Technologies

• Frontend: Modern Web Interface
• Backend: Node.js Server
• Database: Database system supporting vector storage
• AI Integration: OpenAI API for semantic vector generation
• Containerization: Docker support for easy deployment

Search Mechanism

• Vector Embedding: Converts text into high-dimensional vector representations
• Semantic Matching: Searches based on semantic similarity
• Intelligent Filtering: Supports multiple message filtering conditions

📊 Feature Details

1. Intelligent Search

• Supports not only keyword matching but also understands semantic meaning
• Accurately finds relevant messages even when different words are used to express the same meaning

2. Chat Backup

• Automatically backs up Telegram chat history
• Supports multiple chat types (private chats, group chats, channels)

3. Advanced Filtering

• Search by time range
• Filter by message type
• Filter by sender

🔗 Related Links

• GitHub Repository: https://github.com/groupultra/telegram-search
• Issue Feedback: https://github.com/groupultra/telegram-search/issues
• Discussion Forum: https://github.com/groupultra/telegram-search/discussions

📈 Use Cases

• Individual Users: Quickly find historical messages and files
• Team Collaboration: Efficiently retrieve team discussion content
• Content Management: Organize and archive important conversations
• Research Analysis: Analyze chat data and trends