v1.2.0

What's New in v1.2.0

New Features

• TOML Configuration Support: Set default CLI options via config files
  • Priority-based discovery: CLI > env var > local > home > XDG
  • tg-parser config show/init/path commands
  • Global --config/-c option for all commands
• CSV Output Format: Export chat data to CSV (-f csv)
• split-topics Command: Split forum chats by topic into separate files
• mcp-config Command: Auto-configure Claude Desktop/Code MCP integration
• tiktoken Integration: Accurate token counting

CLI Commands (7 total)

• parse - Parse Telegram JSON export with filters
• stats - Show chat statistics
• chunk - Chunk export for LLM processing
• mentions - Analyze @mentions
• split-topics - Split by forum topics
• mcp-config - Configure MCP integration
• config - Manage configuration files

Testing

• 413 tests (152 new tests since v1.0.0)
• pyright strict mode
• ruff linting

See CHANGELOG.md for full details.

v1.0.0 - Production Ready

tg-parser v1.0.0 - Production Ready 🎉

First stable release! Parse Telegram Desktop JSON exports for LLM processing.

✨ Features

• Parse all chat types: Personal, groups, supergroups, forum topics, channels
• Advanced filtering: 9 filter types (date, sender, topic, content, attachments, reactions, forwards, service messages, composite)
• Smart chunking: 3 strategies for LLM context limits (fixed, topic, hybrid)
• Streaming support: Handle large exports (>50MB) with automatic ijson-based streaming
• Multiple formats: Markdown (LLM-optimized), JSON, KB-template with YAML frontmatter
• MCP integration: 6 tools for Claude Desktop/Code
• Production quality: 261 tests, pyright strict mode, Clean Architecture

📦 Installation

```bash

From PyPI

pip install tg-parser

With uv (recommended)

uv tool install tg-parser

From source

git clone https://github.com/mdemyanov/tg-parser.git
cd tg-parser
uv sync --all-extras
```

🚀 Quick Start

```bash

Parse chat export

tg-parser parse ./export.json

Filter by date and sender

tg-parser parse ./export.json --last-days 7 --senders "Alice,Bob"

Chunk for LLM context

tg-parser chunk ./export.json -s hybrid --max-tokens 8000

Get statistics

tg-parser stats ./export.json
```

📚 Documentation

• README - Installation and usage
• ARCHITECTURE - Clean Architecture design
• DEVELOPMENT - Development guide
• TELEGRAM_FORMAT - Telegram JSON spec
• PRD - Product requirements and roadmap
• CHANGELOG - Version history

🙏 Credits

Built with Claude Code following Clean Architecture principles.

See CHANGELOG.md for full version history.