# mayman007/telegramdiscordbridge architecture

> Architecture diagram of the GitHub repository mayman007/telegramdiscordbridge, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-05-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mayman007/telegramdiscordbridge
- Repository: https://github.com/mayman007/telegramdiscordbridge

## Overview

##### Project type and purpose
- This is a small full-stack (or microservice) “bridge” application written in Python.
- Purpose: two-way real-time message relay between Telegram and Discord.

##### File structure
- Top-level scripts:
- main.py – orchestrator / entry point
- telegram_bot.py – Telegram client logic (Pyrogram)
- discord_bot.py – Discord client logic (discord.py)
- example.settings.yaml – sample configuration (API keys, mappings)
- requirements.txt – dependency manifest
- README.md – project overview & setup instructions
- No database or frontend/UI – purely a messaging microservice.

##### README for additional insights
- Uses discord.py v2.x and Pyrogram v2.x
- Configured via YAML (channels to bridge, credentials)
- Runtime prompts only on first Telegram auth

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Configuration and Data
    ConfigLoader["Config Loader"]:::config
    click ConfigLoader "https://github.com/mayman007/telegramdiscordbridge/blob/main/example.settings.yaml"

    %% Internal Modules
    subgraph "Internal Modules"
        direction TB
        TelegramClient["Telegram Client<br/>(Pyrogram)"]:::internal
        click TelegramClient "https://github.com/mayman007/telegramdiscordbridge/blob/main/telegram_bot.py"
        DiscordClient["Discord Client<br/>(discord.py)"]:::internal
        click DiscordClient "https://github.com/mayman007/telegramdiscordbridge/blob/main/discord_bot.py"
        MessageRouter["Message Router<br/>(Bridge Logic)"]:::internal
        click MessageRouter "https://github.com/mayman007/telegramdiscordbridge/blob/main/main.py"
    end

    %% External Services
    subgraph "External Services"
        direction TB
        TelegramAPI["Telegram API"]:::external
        DiscordAPI["Discord API"]:::external
    end

    %% Dependencies
    ConfigLoader --> TelegramClient
    ConfigLoader --> DiscordClient

    %% Message Flow: Telegram to Discord
    TelegramClient -->|"MessageEvent"| MessageRouter
    MessageRouter -->|"send_message()"| DiscordClient
    DiscordClient -->|"API call"| DiscordAPI

    %% Message Flow: Discord to Telegram
    DiscordAPI -->|"Event"| DiscordClient
    DiscordClient -->|"MessageEvent"| MessageRouter
    MessageRouter -->|"send_message()"| TelegramClient
    TelegramClient -->|"API call"| TelegramAPI

    %% Styles
    classDef internal fill:#ADD8E6,stroke:#333,stroke-width:1px
    classDef external fill:#D3D3D3,stroke:#333,stroke-width:1px
    classDef config fill:#90EE90,stroke:#333,stroke-width:1px
```
