Telegram Autopilot

Source: https://github.com/Shor73/telegram-autopilot
Author: @Shor73
License: MIT

AI-powered autopilot for personal Telegram accounts. Responds to private messages as the user when they're unavailable.

Prerequisites

• - Python 3.10+
• Telethon: INLINECODE0
• Telegram API credentials (apiid + apihash from https://my.telegram.org)
• An Anthropic API key (for AI responses)

Setup

1. Get Telegram API Credentials

Direct the user to https://my.telegram.org → API Development Tools → create app.
They need: API ID (number) and API Hash (string).

2. Login Flow

Telegram login requires: phone → OTP code → optional 2FA password.

Critical: OTP codes expire in ~60 seconds. Minimize latency:

• - Use a file-based code exchange (script polls a file every 200ms)
• Or serve a simple web form on a local port for instant code entry
• Never rely on chat round-trip for code delivery — too slow

Run scripts/setup.py with the user's credentials. It handles:

1. 1. Requesting the OTP code
2. Waiting for code via file (enter_code.txt)
3. 2FA password if needed
4. Saving the session file

CODEBLOCK0

The session file (.session) persists auth — login is one-time only.

3. Configure Contacts

Edit config.json to define allowed contacts:

CODEBLOCK1

4. Start Autopilot

CODEBLOCK2

Features

Auto-Reply

• - Responds only to allowed contacts in private chats
• Marks messages as read before replying (natural behavior)
• Simulates typing delay proportional to response length
• Maintains conversation history for context

AI Persona

• - System prompt configurable per-contact (tone, language)
• Never invents facts — says "I'll check and get back to you" for unknowns
• Never reveals it's AI

Notifications

• - Forwards received messages to owner via Telegram bot
• Forwards sent replies for monitoring

Paid Media (Channels Only)

To send paid media:

1. 1. Create a private channel
2. Post media with INLINECODE6
3. Generate invite link and send to recipient

CODEBLOCK3

Management Commands

Stop autopilot: kill the process or send SIGTERM.
Add/remove contacts: edit config.json and restart.

Architecture

CODEBLOCK4

Required Credentials

All secrets are stored in config.json — never commit this file.

Security & Ethics

• - Session security: The .session file grants full access to the account. Protect it like a password.
• Transparency: The AI is instructed to be honest if directly asked whether it's AI.
• OTP server: code_server.py binds to 127.0.0.1 (localhost only). Never expose it to the network.
• Notifications: The skill can forward messages to the owner via bot. Ensure you control the bot token and chat_id.
• Rate limits: Telegram may restrict accounts with aggressive automation. The autopilot uses natural delays.
• One session at a time: Only one process can use a session file. Stop autopilot before running other scripts.
• Platform policies: Using a userbot to auto-reply may violate Telegram ToS. Use at your own risk.