Skip to content

Welcome to tg-note Documentation

**Intelligent Knowledge Base Builder** Telegram bot that automatically transforms your messages, reposts, and articles into a structured knowledge base using AI agents. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/) [Get Started](getting-started/quick-start.md){ .md-button .md-button--primary } [View on GitHub](https://github.com/ArtyomZemlyak/tg-note){ .md-button }

What is tg-note?

tg-note is a Telegram bot that acts as your personal knowledge curator. It receives messages, reposts, and articles through Telegram, analyzes them using AI agent systems, and automatically saves the important information to your GitHub-based knowledge base in structured Markdown format.

Perfect for:

  • 📚 Building a personal knowledge base from Telegram channels
  • 🔬 Organizing research papers and scientific articles
  • 📰 Archiving news and insights from multiple sources
  • 🧠 Creating a searchable second brain

Key Features

  • 🤖 AI-Powered Analysis

    Intelligent content categorization and structuring using advanced agent systems

  • 📝 Automatic Markdown

    Converts any content into well-formatted Markdown files with proper structure

  • 📁 Smart Organization

    Automatic categorization by topics (AI, biology, physics, tech, etc.)

  • GitHub Integration

    Direct commits to your knowledge base repository with version control

  • 👥 Multi-User Support

    Each user can have their own personal knowledge base

  • ⚙ Flexible Configuration

    Configure bot settings directly via Telegram commands

Quick Start

Get started with tg-note in just a few minutes:

git clone https://github.com/ArtyomZemlyak/tg-note.git
cd tg-note
poetry install

# Copy configuration files
cp config.example.yaml config.yaml

# Add your Telegram bot token to .env
echo "TELEGRAM_BOT_TOKEN=your_token_here" > .env

poetry run python main.py

Full Installation Guide →

Agent Types

Choose the right agent for your needs:

Uses Qwen Code CLI for advanced AI processing.

  • ✅ Full integration with Qwen3-Coder models
  • ✅ Automatic TODO planning
  • ✅ Built-in tools: web search, git, github, shell
  • ✅ Free tier: 2000 requests/day

Learn More →

Autonomous Agent

Python-based agent with OpenAI-compatible API support.

  • ✅ OpenAI-compatible API integration
  • ✅ Autonomous planning and decision-making
  • ✅ Function calling support
  • ✅ Works with various LLM providers

Learn More →

Stub Agent

Simple stub agent for testing and MVP.

  • ⚡ Fast and lightweight
  • 🔧 No external dependencies
  • 🧪 Perfect for testing

Learn More →

Architecture Overview

graph TD
    A[Telegram Bot] --> B[Message Processor]
    B --> C[Agent System]
    C --> D[Knowledge Base Manager]
    D --> E[Git Operations]

    style A fill:#e1f5ff
    style C fill:#fff3e0
    style D fill:#f3e5f5
    style E fill:#e8f5e9

Detailed Architecture →

Documentation Sections

Community & Support

License

This project is licensed under the MIT License - see the LICENSE file for details.

**Built with ❤️ by [Artem Zemliak](https://github.com/ArtyomZemlyak)** ⭐ Star this repository if you find it helpful!