Telegram Auto-Translate

A Telegram userbot that automatically translates your outgoing messages using conversation context.

Before	After

How It Works

Your message → Detect languages → Translate with Claude → Clean output → Edit in place

1. Watch - Monitors your outgoing messages
2. Analyze - Gathers recent chat context (default: 10 messages)
3. Detect - Uses GPT-5.6 Luna to identify the target language based on who you're replying to
4. Skip if unnecessary - Won't translate if your message is already in the target language
5. Translate - Claude translates with full conversation context, matching the chat's tone and style
6. Clean - Strips any LLM artifacts (preambles, quotes) from the output
7. Edit - Replaces your original message with the translation

Installation

Via PyPI (Recommended)

pip install telegram-auto-translate

From Source

git clone https://github.com/aimoda/telegram-auto-translate
cd telegram-auto-translate
pip install -e .

Quick Start

# Set required environment variables
# Get TG_API_ID and TG_API_HASH from https://my.telegram.org/apps
export TG_API_ID="your_api_id"
export TG_API_HASH="your_api_hash"
export BEDROCK_AWS_PROFILE="your_aws_profile"

# Run
telegram-auto-translate

On first run, Telethon will prompt for your phone number and login code.

Prerequisites

• Python 3.10+
• Telegram API credentials - Get API_ID and API_HASH from my.telegram.org
• AWS account with Amazon Bedrock access to both the Anthropic (Claude) and OpenAI (GPT) models, plus appropriate IAM permissions

Configuration

Telegram

AWS Bedrock (Claude + GPT)

Both models run on Amazon Bedrock, authenticated with SigV4 request signing from a single AWS profile — there is no separate OpenAI API key. They use different Bedrock endpoints:

• Claude goes through bedrock-runtime (InvokeModel), so it can use the global. cross-region inference profile — dynamic routing with no regional pricing premium.
• GPT goes through the regional Mantle endpoint (https://bedrock-mantle.<region>.api.aws), which is the only way OpenAI models are served on Bedrock.

1. Create an IAM user with programmatic access, then attach an IAM policy with Bedrock invoke permissions:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowBedrockModelInvocationInAUSCANNZUKUS",
            "Effect": "Allow",
            "Action": [
                "bedrock:InvokeModel",
                "bedrock:InvokeModelWithResponseStream"
            ],
            "Condition": {
                "StringEquals": {
                    "aws:RequestedRegion": [
                        "us-east-1",
                        "us-east-2",
                        "us-west-1",
                        "us-west-2",
                        "ca-central-1",
                        "ca-west-1",
                        "eu-west-2",
                        "ap-southeast-2",
                        "ap-southeast-4",
                        "unspecified"
                    ]
                }
            },
            "Resource": [
                "arn:aws:bedrock:*::foundation-model/*",
                "arn:aws:bedrock:*:*:provisioned-model/*",
                "arn:aws:bedrock:*:*:imported-model/*",
                "arn:aws:bedrock:*:*:inference-profile/*"
            ]
        }
    ]
}

2. Add credentials to ~/.aws/credentials:

[telegram-translator-bedrock]
aws_access_key_id = YOUR_ACCESS_KEY
aws_secret_access_key = YOUR_SECRET_KEY

3. Set the profile:

export BEDROCK_AWS_PROFILE="telegram-translator-bedrock"
export BEDROCK_AWS_REGION="us-east-1"  # optional, us-east-1 is default

4. Enable model access for both global.anthropic.claude-opus-5 and openai.gpt-5.6-luna. Claude routes globally via the inference profile, but GPT is served per-region — see model support by AWS Region and set BEDROCK_AWS_REGION to one that serves openai.gpt-5.6-luna.

Usage

telegram-auto-translate [options]

Command-Line Flags

Environment Variables Reference

Examples

Test without editing messages:

telegram-auto-translate --dry-run --debug

Use more context for better translations:

telegram-auto-translate --context-messages 20

Run in a different Bedrock region:

BEDROCK_AWS_REGION="us-east-2" telegram-auto-translate

Troubleshooting

"TG_API_ID and TG_API_HASH are required"

Set both environment variables or pass --api-id and --api-hash flags.

"BEDROCK_AWS_PROFILE is required"

Set BEDROCK_AWS_PROFILE to your AWS credentials profile name. The same profile signs requests for both the Claude and GPT models.

Translation not happening

• Check that there are previous messages in the chat (the bot needs context)
• Your message might already be in the detected target language
• Use --debug to see detection results

"AccessDeniedException" from Bedrock

Verify your IAM policy includes bedrock:InvokeModel permission and that both global.anthropic.claude-opus-5 and openai.gpt-5.6-luna are enabled for your account and region.

First run hangs

Telethon is waiting for your phone number. Enter it in the terminal.

Development Setup

For local development and contributions:

Create and activate virtual environment

python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

Install the package

# Install in editable mode for development
pip install -e .

Run the application

# Option 1: Use the installed command
telegram-auto-translate

# Option 2: Run as module (without installing)
PYTHONPATH=src python -m telegram_auto_translate

Why Bedrock?

Everything runs on Amazon Bedrock: Claude Opus 5 for translation, GPT-5.6 Luna for language detection and output cleaning. One AWS account, one credentials profile, one set of data-handling terms. Claude uses the global. inference profile for cross-region routing without the regional pricing premium.

We prefer Bedrock for its data handling policies:

• Inputs and outputs are not logged by default
• Zero operator access for the GPT models, which are served through Mantle
• Configurable data retention, including zero data retention on eligible accounts