groupultra/telegram-searchView GitHub Homepage for Latest Official Releases
텔레그램 검색: 벡터 검색 및 시맨틱 매칭을 지원하는 강력한 텔레그램 채팅 기록 검색 도구
AGPL-3.0TypeScripttelegram-searchgroupultra 2.8k Last Updated: August 14, 2025
Telegram Search - 스마트 채팅 기록 검색 도구
🔍 프로젝트 개요
Telegram Search는 강력한 Telegram 채팅 기록 검색 도구로, 벡터 검색 및 의미 매칭을 지원합니다. OpenAI의 의미 벡터 기술을 기반으로 하여 Telegram 메시지 검색을 더욱 스마트하고 정확하게 만들어 줍니다.
✨ 주요 기능
- 지능형 의미 검색: OpenAI의 벡터 기술을 기반으로 메시지의 의미를 이해
- 벡터 검색: 고급 검색 알고리즘을 활용하여 효율적인 검색 결과 제공
- 채팅 기록 백업: 채팅 기록을 쉽게 백업
- 사용자 친화적 인터페이스: 간결하고 사용하기 쉬운 디자인
- 크로스 플랫폼 지원: 다양한 운영체제 지원
- 오픈 소스 무료: MIT 라이선스, 완전 오픈 소스
🚀 빠른 시작
환경 요구 사항
- Node.js
- pnpm
- Docker 및 Docker Compose
설치 단계
- 저장소 복제
git clone https://github.com/GramSearch/telegram-search.git
cd telegram-search
- 의존성 설치
pnpm install
- 환경 설정
cp config/config.example.yaml config/config.yaml
- 데이터베이스 컨테이너 시작
docker compose up -d
- 데이터베이스 테이블 구조 동기화
pnpm run db:migrate
- 서비스 시작
# 백엔드 서비스 시작
pnpm run dev:server
# 프론트엔드 인터페이스 시작
pnpm run dev:frontend
- 애플리케이션 접속
브라우저를 열어
http://localhost:3333
에 접속하여 검색 인터페이스를 사용할 수 있습니다.
🔧 기술 아키텍처
핵심 기술
- 프론트엔드: 현대적인 웹 인터페이스
- 백엔드: Node.js 서버
- 데이터베이스: 벡터 스토리지를 지원하는 데이터베이스 시스템
- AI 통합: OpenAI API를 사용하여 의미 벡터 생성
- 컨테이너화: Docker 지원, 쉬운 배포
검색 메커니즘
- 벡터 임베딩: 텍스트를 고차원 벡터 표현으로 변환
- 의미 매칭: 의미 유사성을 기반으로 검색
- 지능형 필터링: 다양한 메시지 필터링 조건 지원
📊 기능 상세 설명
1. 지능형 검색
- 키워드 매칭뿐만 아니라 의미도 이해
- 다른 어휘로 동일한 의미를 표현하더라도 관련 메시지를 정확하게 찾을 수 있습니다.
2. 채팅 백업
- Telegram 채팅 기록 자동 백업
- 다양한 채팅 유형 지원 (개인 채팅, 그룹 채팅, 채널)
3. 고급 필터링
- 시간 범위별 검색
- 메시지 유형별 필터링
- 발신자별 필터링
🔗 관련 링크
- GitHub 저장소: https://github.com/groupultra/telegram-search
- 문제 보고: https://github.com/groupultra/telegram-search/issues
- 토론 게시판: https://github.com/groupultra/telegram-search/discussions
📈 활용 시나리오
- 개인 사용자: 과거 메시지 및 파일 빠르게 검색
- 팀 협업: 팀 토론 내용 효율적으로 검색
- 콘텐츠 관리: 중요한 대화 정리 및 보관
- 연구 분석: 채팅 데이터 및 트렌드 분석