Skip to content

README_JA.md

Latest commit

 

History

History
207 lines (161 loc) · 10.8 KB

README_JA.md

File metadata and controls

207 lines (161 loc) · 10.8 KB

プレビュー

groupultra%2Ftelegram-search | Trendshift

[デモを体験] [简体中文] [English]

Discord Telegram DeepWiki
GitHub Package Version Release Docker / OCI CI

Tip

Telegram で日本語のチャット履歴を検索できずに困ったことはありませんか？

重要なメッセージを探しているのに大量の履歴の中から見つけ出せず、悩んだ経験はありませんか？

Telegram Search なら、日本語メッセージも含めて簡単に検索・エクスポートできます。高度なセマンティック検索で言語を問わず、単語の区切りがなくてもスムーズに検索可能です。

また、ベクトル検索による文レベルのあいまい検索で、必要な情報をより素早く・正確に見つけ出せます。

💖 スポンサー

Sponsors

✅ 機能ハイライト

📦 エクスポート & バックアップ

  • 複数のデータベースエクスポートに対応：PGlite および PostgreSQL をサポート
  • メディアリソースを MinIO オブジェクトストレージへ自動バックアップ、手動操作不要
  • メッセージのエクスポート時に、ベクトル埋め込み生成＆分かち書きを自動実行し、後の検索性を向上
  • リアルタイム同期で最新のチャット内容を自動的に取得・更新

🔍 チャット履歴検索

  • 自動インテリジェント分かち書きで多言語チャットも精度高く検索
  • あいまい一致とベクトルセマンティック検索の両方を統合し、高効率な探索を実現
  • 画像セマンティック検索：画像 embedding によるテキストからの画像検索
  • 検索結果の無限スクロールで、よりスムーズな閲覧体験
  • RAG AI 質問応答：AI との直接対話で、履歴の文脈に基づきすぐに解答

🤖 Telegram Bot

  • Bot 経由でメッセージの検索・エクスポート
  • メッセージ deep link でワンクリックで元の会話へジャンプ

🚀 高度な機能

  • 未読メッセージの自動要約：全未読メッセージをワンクリックでまとめ、重要ポイントを抽出
  • 日付範囲フィルタリングで検索結果を素早く絞り込み
  • 右クリックメニューから Telegram の元メッセージへジャンプ（モバイル対応）

🛣️ ロードマップ展望

🧠 AI 能力の強化

  • 会話まとめの自動生成
  • 「スーパー・ブレイン」：履歴メッセージから人物・イベントの知識グラフを自動構築

🔗 メディア・リンク連携拡張

  • 「保存済みメッセージ」フォルダをインテリジェントに整理、コンテンツ管理性を向上
  • リンク・画像の深いインデックス化（ウェブ要約、画像 OCR 文字認識、キャプション生成など）

🌐 マルチプラットフォーム対応

  • Discord 等他の主要チャット・ SNS への拡張で統合検索＆バックアップに対応

🎉 今すぐお試し

オンラインデモを用意しています。デプロイ不要で Telegram Search の全機能をすぐ体験できます。

アクセス：https://search.lingogram.app

Warning

暗号通貨等の発行はしていません。詐欺にご注意ください。

このツールはご自身のチャット履歴を検索・エクスポートする用途限定です。違法目的での利用は禁止します。

🚀 クイックスタート

  1. Telegram Search 用のディレクトリを作成：
mkdir telegram-search
cd telegram-search
  1. Docker Compose ファイルと環境ファイルをダウンロードし、全サービス（DB ・ MinIO 等）を起動：
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
docker compose -f docker-compose.yml up -d
  1. ブラウザで http://localhost:3333 にアクセスしてすぐ使い始められます 🎉

Docker Image を使用してデプロイ

MinIO の関連パラメータが未設定の場合、メディアファイルはデフォルトでローカルの data/media ディレクトリに保存されます。

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

環境変数のカスタマイズ

Important

AI 埋め込み & LLM の設定は現在「アカウントごとに」アプリ内で設定します（設定 → API）。

変更が完了した .env ファイルを再度 docker compose -f docker-compose.yml up -d で起動してください。

すべての環境変数は省略可能です。指定しない場合、デフォルト値が使用されます。

環境変数 説明 サンプル値
TELEGRAM_API_ID my.telegram.org で取得した Telegram アプリ ID 611335
TELEGRAM_API_HASH my.telegram.org で取得した Telegram アプリ Hash d524b414d21f4d37f08684c1df41ac9c
DATABASE_TYPE データベース種別。postgres または pglite を指定 pglite
DATABASE_URL PostgreSQL 用接続文字列（DATABASE_TYPE=postgresの場合のみ記入） postgresql://postgres:123456@pgvector:5432/postgres
TELEGRAM_BOT_TOKEN @BotFather で作成した Bot トークン 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11
PROXY_URL 利用可能なプロキシ URL（例：socks5://user:pass@host:port など） socks5://user:pass@host:port
PORT サーバー HTTP/WebSocket のリッスンポート 3333
HOST サーバーのバインドアドレス 0.0.0.0
BACKEND_URL Nginx 等でリバースプロキシを使う場合の上流サーバー URL http://127.0.0.1:3333
MINIO_URL MinIO サービスホスト名または IP minio
MINIO_ACCESS_KEY MinIO アクセスキー minioadmin
MINIO_SECRET_KEY MinIO シークレットキー minioadmin
MINIO_BUCKET MinIO のバケット名 telegram-media

Docker Image を使用してデプロイ

必要に応じて環境変数を編集してください。

docker run -d --name telegram-search \
  -p 3333:3333 \
  -e DATABASE_TYPE=postgres \
  -e DATABASE_URL=postgresql://postgres:123456@localhost:5432/postgres \
  ghcr.io/groupultra/telegram-search:latest

💻 開発ガイド

ブラウザ専用モード

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 .env.example .env

docker compose up -d pgvector minio

pnpm run server:dev
pnpm run web:dev

📖 さらに詳しい開発やアーキテクチャ情報： CONTRIBUTING.md

🚀 活動状況

Alt

Star History Chart