https://github.com/kalanakt/telegraph

Build Telegram bot automations with a visual flow builder, queue-backed execution, and run history.
https://github.com/kalanakt/telegraph

clerk creem flowbuilder nextjs nodejs open-source postgresql prisma railway react redis s3-storage telegram telegrambot vitest webhook worker

Last synced: 12 days ago
JSON representation

Build Telegram bot automations with a visual flow builder, queue-backed execution, and run history.

• Host: GitHub
• URL: https://github.com/kalanakt/telegraph
• Owner: kalanakt
• License: apache-2.0
• Created: 2026-03-24T04:47:11.000Z (3 months ago)
• Default Branch: main
• Last Pushed: 2026-04-19T16:02:50.000Z (about 2 months ago)
• Last Synced: 2026-04-19T17:38:30.686Z (about 2 months ago)
• Topics: clerk, creem, flowbuilder, nextjs, nodejs, open-source, postgresql, prisma, railway, react, redis, s3-storage, telegram, telegrambot, vitest, webhook, worker
• Language: TypeScript
• Homepage: https://telegraph.us.com
• Size: 3.07 MB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Agents: AGENTS.md

Awesome Lists containing this project

README

          










  

  

  

# Telegraph

**Build and run Telegram bot automations with a visual flow builder.**

[![CI](https://github.com/kalanakt/telegraph/actions/workflows/ci.yml/badge.svg)](https://github.com/kalanakt/telegraph/actions/workflows/ci.yml)

[![GitHub stars](https://img.shields.io/github/stars/kalanakt/telegraph?style=flat)](https://github.com/kalanakt/telegraph/stargazers)

[Website](https://telegraph.us.com) · [Cloud](https://telegraph.us.com/dashboard) · [Telegram](https://t.me/jointelegraph) · [Contributing](CONTRIBUTING.md)



## What Is Telegraph?

Telegraph is a SaaS platform for building Telegram bot automations without hand-writing the execution layer yourself. It combines a visual builder, webhook ingestion, workflow orchestration, queued action processing, and operational safeguards into one system for shipping Telegram bots at scale.

## Features

- Visual flow builder for Telegram automations

- Trigger, condition, and action-driven workflow execution

- Shared orchestrator logic used by both the web app and worker

- BullMQ-backed action processing for reliable async execution

- Billing and plan-limit enforcement during orchestration

- Encrypted bot token storage with application-level security

- Event deduplication and action idempotency for safer replays

## Architecture



  



## Repository Layout

| Path | Responsibility |

| --- | --- |

| `apps/web` | Next.js dashboard, API routes, webhook entrypoint, and flow builder UI |

| `apps/worker` | BullMQ worker that consumes and executes queued actions |

| `packages/shared` | Core domain logic, orchestrator, Telegram client, validation, and queue contracts |

| `prisma` | PostgreSQL schema and migrations |

| `tests` | Vitest unit and integration tests |

See [CONTRIBUTING.md](CONTRIBUTING.md) for the full development workflow, worktree support, testing, and troubleshooting.