Tg Content Factory

TG Agent

[](https://github.com/axisrow/tg_content_factory/releases)

A personal Telegram monitoring toolkit — collect messages, search across channels, get keyword alerts. Built as a pet project for my own use.

[Русская версия](README.ru.md)

Features

• All chat types — channels, supergroups, gigagroups, forums, public and private
• Multi-account with automatic flood-wait rotation
• 3 search modes — local DB (FTS5), direct Telegram API, AI/LLM-powered
• AI Agent — interactive chat powered by claude-agent-sdk with automatic deepagents fallback when Claude SDK is not configured; developer override is available in Settings
• All search results are cached in a local SQLite database
• Scheduled collection — incremental message fetching on a timer
• Keyword monitoring — plain text and regex, with Telegram bot notifications
• Built-in anti-spam filters — deduplication, low-uniqueness detection, cross-channel spam, subscriber ratio filters, non-Cyrillic content filter
• Task queue — background job processing with status tracking
• Web dashboard — FastAPI + Bootstrap 5, manage everything from a browser
• Security — session encryption (Fernet + PBKDF2), web panel password, HTTP Basic fallback, HMAC-signed cookies
• Docker-ready

Quick Start

Prerequisites

• Python 3.11+
• Telegram API credentials from my.telegram.org/apps

Installation

pip install tg-agent

Or from source:

pip install .
cp .env.example .env

Edit `.env`:

TG_API_ID=your_api_id
TG_API_HASH=your_api_hash
WEB_PASS=your_password
SESSION_ENCRYPTION_KEY=    # encrypts account session strings in DB
LLM_API_KEY=               # optional, for AI search
AGENT_MODEL=               # optional, Claude SDK model override
AGENT_FALLBACK_MODEL=      # optional, provider:model for deepagents fallback
AGENT_FALLBACK_API_KE