Repository navigation
AutoTelegramForward v2.0.0
AutoTelegramForward v2.0.0 — True Single-File Cross-Platform Release
One Single Executable, All 4 Microservices.
AutoTelegramForward is a high-performance Telegram MTProto forwarding and routing suite engineered with clean microservice boundaries. Every platform release is a self-contained, native single executable that embeds and orchestrates all four decoupled services with zero external dependencies (no Python, Go, Rust, Node.js, or compiler toolchains required on host systems):
- Python Core Engine (:6001) — Telegram MTProto client pool, rule engine, smart routing, link sanitization, and multi-provider AI text transformations.
- Python Logger Service (:6002) — Telemetry, queryable structured logs with dedicated SQLite storage.
- Go REST API (:8080) — Production control-plane, OpenAPI REST endpoints for rules, sessions, and telemetry.
- Rust Axum Web Gateway & React Dashboard (:8088) — Zero-dependency web server embedding the React Single Page App, providing security headers, high-throughput reverse proxying to the Go API, and health metrics.
Quick Start Guide (Linux / macOS / WSL)
-
Download the single-file binary:
curl -fsSL https://github.com/Opselon/AutoTelegramForward/releases/latest/download/atf-linux-x64 -o atf && chmod +x atf(For Apple Silicon macOS, use
atf-macos-arm64; for macOS Intel, useatf-macos-x64) -
Interactive Onboarding & Setup Wizard:
./atf setup
Only asks for your Telegram Bot Token from @BotFather and optional Admin User ID.
To run non-interactively (CI/CD):./atf setup --token "123456:ABC-DEF..." --admin 123456789 --lang en --start -
Start All Services with One Command:
./atf start
-
Verify Live Status & Health:
./atf status ./atf health
-
Open Web Dashboard:
Openhttp://localhost:8088in your browser to access the live React Management Dashboard.
Windows (PowerShell)
curl.exe -fsSL https://github.com/Opselon/AutoTelegramForward/releases/latest/download/atf-windows-x64.exe -o atf.exe
.\atf.exe setup
.\atf.exe start
.\atf.exe statusProduction OS Background Service (Auto-Start on Boot)
Run all services continuously in the background managed by your operating system:
# Linux (systemd user unit)
./atf service install
# Check service status
./atf status
# Tail live service logs
./atf logsDocker & Kubernetes Deployments
Docker Compose (All 4 Microservices):
curl -fsSL https://raw.githubusercontent.com/Opselon/AutoTelegramForward/master/docker-compose.yml -o docker-compose.yml
docker compose up -d
# or via CLI:
./atf docker upKubernetes (Production Cluster Manifests):
./atf k8s apply
# or kubectl:
kubectl apply -f https://raw.githubusercontent.com/Opselon/AutoTelegramForward/master/k8s/all-in-one.yamlOfficial Single-File Artifacts
| Binary | Platform | Architecture | Verification |
|---|---|---|---|
atf-linux-x64 |
Linux | x86_64 | Self-contained single-file executable |
atf-linux-arm64 |
Linux | ARM64 / aarch64 | Raspberry Pi 4/5, ARM VPS, Graviton |
atf-macos-x64 |
macOS | Intel x86_64 | Self-contained single-file executable |
atf-macos-arm64 |
macOS | Apple Silicon (M1/M2/M3/M4) | Self-contained single-file executable |
atf-windows-x64.exe |
Windows | x64 | Windows native standalone executable |
atf-*-portable.tar.gz |
Cross-platform | Portable directory | One-directory portable bundle |
| Android | ARM64 | Flutter release APK (per-ABI) | |
| Android | ARMv7 | Flutter release APK (per-ABI) | |
| Android | x86_64 | Flutter release APK (per-ABI) | |
| Android | Universal | Play Store App Bundle | |
| Any POSIX | Source bundle | Source distribution |
SHA-256 Checksums Verification
Download SHA256SUMS.txt from the release assets and verify integrity:
sha256sum -c SHA256SUMS.txtWhat's Changed
- fix(dispatcher): prevent Pyrogram Str UTF-16 surrogate crash by @Opselon in #40
- feat(security): secure admin and client control planes with immutable ID authorization by @Opselon in #41
- feat(rules): 1:1 task overview and advanced settings parity across bot, web, and mobile by @Opselon in #42
- feat(core, api, web, mobile): TMA auth, full task lifecycle parity, and web dashboard bugfix by @Opselon in #43
- feat: Phase 2 advanced settings runtime execution + typed metadata validation by @Opselon in #44
- feat: wire keyword-reply add-on into pipeline runtime by @Opselon in #45
- feat: v2.0 app update parity (cleaner, duplicate filter, forward header, reply sync, 7 locales) by @Opselon in #46
- feat: v2.0 dashboards parity and android session/password persistence by @Opselon in #47
- chore(logging): standardize professional [PIPELINE:...] structured logging by @Opselon in #48
- fix(auth): handle updated_at column in admin bootstrap by @Opselon in #49
- fix: multilingual 1:1 UI translation and parity clean-up by @Opselon in #50
- fix: import SUPPORTED_LANGUAGES for _resolve_lang by @Opselon in #51
- fix(bot): multilingual dialog picker UI/UX, session reconnect & toast parity by @Opselon in #52
- fix(i18n): eliminate hardcoded strings in rule creation, main menu & submenus by @Opselon in #53
- fix(health): resolve live topology health checks and core gRPC network discovery by @Opselon in #54
- chore(release): bump version to 2.0.0 across all platforms by @Opselon in #55
Full Changelog: v1.5.2...v2.0.0