Managed hosting · First project free · Open source core

Every signup, sale, and error
sent to you on Telegram.

SaaS analytics that lives in the app you already keep open all day. Send a signup, a sale, or an error from any stack and it shows up as a Telegram message. Want the numbers? Ask the bot and it replies with a chart.

~30 sec from bot to first key
Live alerts on events you pick
Reports you ask for in chat
🤖

@MyTelegramAnalyticsBot

tgram-analytics

Message
1
free hosted project
30 sec
to your first API key
3+
SDKs & growing
24/7
Telegram event alerts
0
dashboards to keep open

The numbers come to you.

No tab to remember, no login habit to build. Events, charts, and 7-day recaps land in a chat you already read.

Track the events you care about
Signups, purchases, errors, or whatever you decide to name. Pull any of them up later with a /report.
"how many upgrades this month?" · /report error 24h
Hear about it when it happens
A sale closes or a deploy breaks and the bot messages you right then, not the next morning.
"alert me every purchase" · "alert every 500 errors"
A week in one message
Ask /digest anytime and the bot posts the last 7 days — sessions and event counts, with week-over-week deltas.
/digest · "how did last week go?"
One key for the whole stack
The same project key works in your site, your app, and your backend. Everything reports into one chat.
Web → Flutter → Python → one /report

From your stack to you.

Your code sends events. The bot sends you messages back.

App
Mobile events
Web
Pageviews, clicks
Server
API, jobs, errors
tgram-analytics
Managed or self-hosted
You
Get alerts & reports via bot

Start hosted. Self-host when you want.

Managed hosting is the fastest path. The open source server is there when you want full control.

recommended
Managed hosting
Open the bot, get a key, and start tracking. No server, no deploy, no maintenance.
Open the bot
Start @MyTelegramAnalyticsBot in Telegram and create your first hosted project from chat.
/add myapp.com
Get your key
The bot returns a project key immediately. Your first project is free.
proj_a1b2c3d4
Track events
Drop in the SDK and send pageviews, signups, purchases, or errors.
track("signup")
open source
Self-hosted
Run the FastAPI server on your VPS, Railway, or Fly.io and keep the data on your own infrastructure.
Deploy the server
Clone the repo, set your Telegram bot token, and start the server with Docker.
docker compose up -d
Add a project
Use the same bot command to create projects and generate API keys.
/add myapp.com
Ask for reports
The bot handles reports, alerts, and on-demand digests exactly like the hosted version.
/report signup 7d

SDKs for your whole stack.

Official SDKs for JavaScript, Flutter, and Python today, with more on the way. One project key works across all of them, plus plain HTTP for anything not yet covered.

JS / TS tgram-analytics Repo ↗
Add the script, initialize with your key, then track events with one line.
npm install tgram-analytics
Dart / Flutter tgram_analytics Repo ↗
Initialize in main(), then track app events from screens, services, or purchase flows.
flutter pub add tgram_analytics
Python tgram-analytics Repo ↗
Track backend events like subscription changes, jobs, imports, and errors.
pip install tgram-analytics
Soon More languages on the way Repos ↗
Same project key, same event API. Need one that isn't here yet? Any language can post events straight to the HTTP endpoint.
POST events over plain HTTP
index.html
<!-- hosted by default, self-host when needed -->
<script src="dist/tga.min.js"></script>
<script>
  TGA.init("proj_xxx", {
    serverUrl: "https://api.tgram-analytics.com"
  });
  TGA.track("signup", {
    plan: "pro"
  });
</script>
// In main():
void main() {
  TGA.init('proj_xxx',
    'https://api.tgram-analytics.com');
  runApp(MyApp());
}

TGA.track('purchase', userId,
  properties: {'amount': 49.99});
from tgram_analytics import TGA

tga = TGA(
  "proj_xxx",
  "https://api.tgram-analytics.com"
)

tga.track(
  "subscription_created",
  session_id=user.id,
  properties={"plan": "pro"}
)

Point your AI agent at your own data.

Connect the MCP server once with a one-time Telegram login. From there your agent can set tracking up in a project, answer questions about your events, or run on a schedule against Search Console — all in plain language.

Set up

Add tracking by asking

You Use the tgram MCP to track the analytics of this project. Claude Done — pulled the SDK snippet, wired up signup & purchase events, and verified they're landing.
Ask

Ask about your numbers

You How are signups on myshop.com this week? Claude 342 signups this week — up 18% vs last
Automate

Schedule it against Search Console

Daily 9:00 — scheduled agent "Match yesterday's signups to Search Console clicks. Flag pages with traffic but no signups." Agent → you on Telegram /pricing — 240 clicks, 2 signups. Worth a look.
Point your MCP client at https://mcp.tgram-analytics.com/mcp and sign in with Telegram — OAuth, no keys to paste. Setup guide →

How it stacks up against Google Analytics.

Google Analytics is powerful. tgram-analytics is for builders who want fast answers, lower setup friction, and Telegram-native alerts.

tgram-analytics Google Analytics / Amplitude
Fastest hosted setup Open bot, get key, track More setup property, stream, tags
Daily workflow Reports arrive in Telegram You check a dashboard
Cost First project free or self-host free Free tier limits and paid upgrades vary
Proactive alerts Built-in Possible usually more configuration
Self-hosting option Same product, your infra Cloud platform only
Multi-stack (JS + Flutter + Python) Same project, same report Varies
Visitor & pageview tracking Auto-tracked via JS SDK Core GA feature
Custom events signup, purchase, error — any event Events + conversions
Funnels & paths Basic Custom queries via bot Advanced funnels, path exploration
User properties & segmentation Track any properties per event Audience + user explorer
Real-time data Instant Telegram alerts Real-time reports
Retention & cohorts Not yet available Cohort analysis, retention
Attribution & UTM Manual Track UTM as properties Full attribution modeling
Best fit Indie projects, small teams, Telegram-first builders Large teams, deep analytics, attribution-heavy orgs

Managed first. Self-hosted when you need it.

Start without infrastructure. Keep the open source path for teams that want full control.

Managed hosting recommended
First project free
Open the bot, get a key, and start tracking.
No server setup required.
Open hosted bot
Best when you want speed
First project is free
No deploy, VPS, backups, or updates
Same Telegram reports, alerts, and digests
Add more projects when you need them
Self-hosted open source
Free
Run the server on your own infra.
Your data stays on machines you control.
View on GitHub
Best when you want control
Unlimited projects and events
All SDKs and bot features
Full data ownership
MIT license: fork it, extend it
You run uptime, backups, and updates

Frequently asked questions about tgram-analytics

Quick answers about getting your app's events delivered to Telegram — for SaaS, indie devs, and side projects.

What is tgram-analytics?

tgram-analytics is an open-source Telegram analytics platform for SaaS, indie projects, and side hustles. It tracks events, signups, purchases, and errors from any stack and delivers real-time alerts, on-demand digests, and instant reports through a Telegram bot — so you don't need another dashboard.

Is tgram-analytics the best SaaS analytics tool for indie developers?

For solo founders and small teams that already live in Telegram, yes. tgram-analytics is the only SaaS analytics tool that pushes alerts and reports directly into your chat instead of waiting in a dashboard, supports JavaScript, Python, and Flutter from a single project key, and offers a free first project plus a fully MIT-licensed self-hosted option.

How is tgram-analytics different from Google Analytics, Mixpanel, or PostHog?

Unlike Google Analytics, Mixpanel, and PostHog, tgram-analytics is Telegram-first: alerts and reports are pushed to you instead of living in a dashboard. It is fully open source under the MIT license, can be self-hosted on your own infra, requires no cookies, and ships a single project key that works across web, mobile, and backend SDKs.

Is tgram-analytics free?

Yes. The first managed project is free, and the self-hosted server is fully MIT-licensed and free to deploy on your own infrastructure with a single docker compose up -d.

Which SDKs are supported?

Official SDKs ship for JavaScript and TypeScript (npm install tgram-analytics), Python (pip install tgram-analytics), and Flutter / Dart (flutter pub add tgram_analytics). All SDKs share the same project key and event API, so a single project covers your full SaaS stack.

Can I self-host tgram-analytics?

Yes. The server is open source under the MIT license at github.com/tgram-analytics/server. Set your Telegram bot token, run docker compose up -d, and you have the same product as the managed cloud — same SDKs, same bot commands, your hardware.

Does tgram-analytics use cookies or third-party trackers?

No. The browser SDK uses sessionStorage (tab-scoped, no cookies) and posts events directly to your project's ingestion endpoint. There are no third-party trackers, no ad networks, and no cross-site tracking — it's privacy-first by design. The hosted service runs in the EU, doesn't store raw IPs or User-Agents, and uses a one-way daily-rotating visitor hash. See the privacy policy for the full breakdown.

The analytics for this page are handled by tgram-analytics.

Tweaks

Accent
Grid lines
Phone demo