asxpi/tg-channel-analysis
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Add README and update CLAUDE.md with project docs

Browse source
This commit is contained in:
Sergei Poljanski 2026-02-22 23:00:23 +02:00
commit 8a84145e15
Signed by: asxpi
GPG key ID: 4F8851660FA4121B
2 changed files with 141 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

38
CLAUDE.md
View file

@ -4,4 +4,40 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
## Overview
This is a new, empty project. Update this file as the codebase takes shape.
Telegram Channel Analyzer Bot — fetches public channel history via Telethon, analyzes with Claude AI (chunked summarization pipeline), delivers reports via aiogram bot.
## Stack
- **Python 3.12**, async throughout
- **aiogram 3** — Telegram bot interface (commands, inline keyboards, progress messages)
- **Telethon** — userbot client for reading public channel history
- **anthropic** (AsyncAnthropic) — Claude API with streaming
- **pydantic-settings** — config from environment variables
## Architecture
- Both aiogram and Telethon share one asyncio loop (no threads)
- Telethon client is attached to the bot instance in `__main__.py`
- Analysis pipeline: Fetch → Chunk (token-bounded) → Summarize each chunk → Synthesize final report
- Rate limit handling: semaphore(1), 60s cooldown between chunks, retry with backoff on 429
- Output: Markdown→HTML conversion, split on section boundaries at 4000 chars
## Key Files
- `bot/config.py` — all settings from env vars, `CLAUDE_MODEL` selects the model
- `bot/services/analyzer.py` — Claude API calls, adaptive thinking only for opus-4-6
- `bot/services/chunker.py` — `MAX_TOKENS_PER_CHUNK` and `CHARS_PER_TOKEN` control chunking
- `bot/prompts/` — prompt templates per report type (chunk_summary.py, synthesis.py)
## Running
- Container-based: `Containerfile` + `compose.yml`
- `--login` flag for interactive Telethon session creation
- Session persists in `data/` volume
- `.env` file must not have inline comments (Podman/Docker limitation)
## Common Tasks
- To change chunk size: edit `MAX_TOKENS_PER_CHUNK` in `bot/services/chunker.py`
- To add a report type: add to `ReportType` enum, add prompts in both `prompts/` files
- To change model: set `CLAUDE_MODEL` env var; thinking params auto-adapt in `analyzer.py`