Skip to content
@tgram-analytics

Tgram Analytics

Send your analytics to Telegram. Self-hosted bot for indie devs - track events, get alerts and charts without leaving your chat.

tgram-analytics

⚠️ Independent open-source project. Not affiliated with, endorsed by, or connected to Telegram Messenger LLP in any way. "Telegram" is a trademark of Telegram Messenger LLP.


Website analytics delivered to your Telegram chat.

No dashboard to log into. No new tool to learn. No data leaving your server. Your Telegram bot tells you what's happening with your website or app — signups, purchases, errors — whenever you ask, or automatically on a schedule.


How it works

flowchart LR
    subgraph Sources["📡 Data Sources"]
        A["🌐 Website"]
        B["📱 App"]
    end
    subgraph SDKs["📦 Client Libraries"]
        JS["tgram-analytics-js"]
        PY["tgram-analytics-py"]
        SW["..."]
    end
    S["⚙️ tgram-analytics\nserver"]
    T["🤖 Telegram Bot"]
    U["😎 You"]
    A --> JS
    A --> PY
    B --> SW
    JS -- "track · pageview" --> S
    PY -- "track · pageview" --> S
    SW -- "track · pageview" --> S
    S <-. "queries & reports" .-> T
    T <-. "messages" .-> U
    style Sources fill:#2b2b2b,stroke:#555,color:#fff
    style SDKs fill:#2b2b2b,stroke:#555,color:#fff
    style S fill:#0088cc,stroke:#006699,color:#fff
    style T fill:#0088cc,stroke:#006699,color:#fff
    style U fill:#333,stroke:#555,color:#fff
Loading

1. Deploy the server once — on a VPS, Railway, Fly.io, wherever you like. Everything runs on your infrastructure. Your data never leaves.

2. Add your project — open Telegram, type /add myapp.com. The bot gives you an API key.

3. Drop in the tracker — one <script> tag for websites, one package for Flutter.

4. Ask your bot/report signup sends you a chart. Right there in Telegram.


What you can do

  • 📊 /report <event> — chart any event across any time range
  • 🔔 Alerts — "tell me every time someone makes a purchase"
  • 📅 Scheduled reports — "every Monday, send me last week's signups"
  • 🔑 Multi-project — one bot, many projects

Repos

Repo What it is
server FastAPI backend + Telegram bot — deploy this
tgram-analytics-js <script> tracker for websites
tgram-analytics-flutter Flutter SDK

Why not Google Analytics?

tgram-analytics Google Analytics / Amplitude
Login required ❌ It's in Telegram
Your server, your data
Price Free (server costs) Free → paid
Proactive alerts ✅ Built-in Paid feature
GDPR-friendly ✅ No third parties Complicated
Setup time ~5 min 15–30 min

Self-hosted. Open source. No dashboards. Just Telegram.

Popular repositories Loading

  1. server server Public

    Self-hosted website analytics delivered to your Telegram chat. No dashboards, no third-party servers.

    Python

  2. .github .github Public

  3. tgram-analytics-js tgram-analytics-js Public

    Lightweight, privacy-first JS/TS SDK for tgram-analytics — zero dependencies, < 2 KB gzipped

    TypeScript

Repositories

Showing 3 of 3 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…