AI Developer Tools

Telegram AI Secretary

Self-hosted AI notification filter for Telegram that uses LLMs to prioritize messages and send only important alerts via ntfy.

Telegram AI Secretary logo

Telegram AI Secretary

Visit website

What is Telegram AI Secretary?

Telegram AI Secretary is a self-hosted AI notification filter for Telegram that listens to incoming messages, filters noisy chats, and sends only important alerts via ntfy.

Telegram AI Secretary vs Similar AI Tools

Pricing ModelFreeFree, FreemiumFree, Custom PricingFree
Free Credits
Key Features
  • Listens to Telegram messages and call events from a user account
  • Drops noisy group messages unless they mention you
  • Sends calls and matching fast rules directly to ntfy
  • Conversational setup
  • Automated QA testing
  • Browser-based testing
  • Loop of Death prevention via identical sequential tool call detection
  • Real-time budget enforcement with client-side token tracking
  • Execution timeouts to prevent hung threads on dead APIs
  • Consistent characters across shots using anchor images
  • Animatic creation (still frames + TTS) for cheap iteration
  • Spec-driven video assembly with cuts, music, ambience, and fades
Pros
  • Reduces notification noise using AI context
  • Self-hosted for privacy and control
  • Easy AI-guided setup
  • Automates QA workflows
  • Prevents runaway costs and infinite loops in AI agents
  • Easy one-line integration with popular frameworks
  • Open source and fully customizable
  • Proven pipeline with multiple finished films
Cons
  • Requires technical setup and Python environment
  • Only works with Telegram
  • Limited to web apps
  • Requires a live URL
  • AGPLv3 license requires open-sourcing for closed-source use
  • HITL console not suitable for headless production APIs
  • Requires multiple paid API subscriptions
  • Complex setup and steep learning curve
Best For
  • Individuals overwhelmed by Telegram notifications
  • Users who want a self-hosted AI-powered notification filter
  • Developers
  • QA engineers
  • Developers building autonomous AI agents
  • Teams needing runtime safety and cost controls
  • AI filmmakers looking for a complete pipeline
  • Creators wanting to produce short films with consistent characters

How to use Telegram AI Secretary?

  1. 1Clone the repository and set up a Python virtual environment.
  2. 2Install dependencies with pip.
  3. 3Configure .env with Telegram API credentials and ntfy topic.
  4. 4Run the listener interactively to create a Telethon session.
  5. 5Run the notification agent to filter and send alerts.
  6. 6Manage fast rules and DND state via CLI.

Telegram AI Secretary Key Features

  • Listens to Telegram messages and call events from a user account
  • Drops noisy group messages unless they mention you
  • Sends calls and matching fast rules directly to ntfy
  • Sends private human messages to Claude with recent conversation context
  • Keeps up to 20 messages from the current private conversation segment
  • Supports temporary fast rules and do-not-disturb state from the CLI

Telegram AI Secretary Use Cases

  • Keep Telegram muted while still receiving urgent DMs
  • Get notified when someone asks 'are you home?' or 'can we meet today?'
  • Let calls and same-day coordination bypass do-not-disturb
  • Ignore group chatter unless you are mentioned
  • Send critical ntfy alerts when someone is waiting outside

Telegram AI Secretary Pricing & Free Credits

Telegram AI Secretary currently operates on a Free model.

This tool is completely free to use

Free

$0

Open-source self-hosted software

Telegram AI Secretary Pros & Cons

Pros

  • Reduces notification noise using AI context
  • Self-hosted for privacy and control
  • Supports fast rules to avoid unnecessary LLM calls
  • Open-source and customizable

Cons

  • Requires technical setup and Python environment
  • Only works with Telegram
  • Depends on external LLM (Claude) and ntfy service

What is Telegram AI Secretary best for?

  • Individuals overwhelmed by Telegram notifications
  • Users who want a self-hosted AI-powered notification filter
  • Developers comfortable with CLI and Python

Telegram AI Secretary FAQ

Top free alternatives to Telegram AI Secretary

B

Personal GitHub Pages site by Basert, currently displaying default welcome content and instructions for using GitHub Pages with Jekyll.

Free
Termaxa logo

A cooperative gate for shell commands that AI agents run, providing previews, backups, policy enforcement, and audit for tools like Claude Code and Cursor.

Free
Agentcard logo

Agentcard provides agent-friendly card issuing and payment infrastructure for AI agents, enabling 5-minute setup and autonomous purchases.

Free
Oodle AI logo

Oodle AI provides agent observability with fast trace search, S3-based storage, and out-of-the-box insights to detect silent failures in AI agents.

Free
Jacquard logo

Jacquard is a small programming language designed for running, reviewing, and trusting programs written by machine-learning models and reviewed by people.

Free
Perfai Security logo

Autonomous security testing platform that finds and fixes access control vulnerabilities in live AI-built apps.

Free
Octolens logo

AI-powered social listening tool that monitors Reddit, X, LinkedIn, and 10+ other platforms, filters mentions with AI, and delivers them to your stack via API, Slack, or webhooks.

Free
Opper AI logo

A unified AI gateway providing access to 300+ leading models through one EU-hosted, GDPR-compliant API with an OpenAI SDK-compatible interface.

Free

Best alternatives AI Tools to Telegram AI Secretary

Replay QA logo

AI-powered tool that walks you through setting up QA for your app by entering its URL.

SHACKLE logo

SHACKLE is a runtime governance layer and conformance standard for autonomous AI agents, enforcing guardrails, budget/loop limits, and policy constraints in real time.

movie-gen logo

An open-source pipeline for creating short films (5–12 minutes) using AI tools for video, images, voices, and music.

Agent Search Engine logo

An independent, curated index and search engine for AI agents, MCP servers, frameworks, and infrastructure tools, ranked by maintained adoption.

B

Personal GitHub Pages site by Basert, currently displaying default welcome content and instructions for using GitHub Pages with Jekyll.

Free
DeepSQL logo

DeepSQL is an AI DBA that monitors workloads, optimizes slow queries, and cuts database costs via a self-hosted agent with MCP and Slack integration.

Panguard AI logo

Open-source platform for real-time AI agent security, auditing skills and runtime with community-driven threat rules.