Repolode
Submit
aozorae

aozorae/Edgechat

Self-hosted team chat running on Cloudflare Workers, with realtime messaging, a two-way Telegram bridge, and server-side encrypted messages and files.

Open-source alternative to:SlackDiscord

View on GitHubWebsite
Stars
1,250
Forks
476
Open issues
2
Last commit
2 days ago

What is it?

EdgeChat is an open-source team chat system that runs entirely on Cloudflare. It provides group chats and direct messages, voice messages, file sharing, and one-to-one voice calls. The app and its data resources are deployed to your own Cloudflare account, and GitHub Actions handles deployment and updates, so you do not need to maintain a persistent server.

Groups can be bound to a Telegram group so that messages sync in both directions, letting Telegram members keep using their existing client. Two separately deployed EdgeChat instances can also link a group through a one-time invite code. An experimental WebMCP interface lets compatible AI clients sign in, read sessions and send messages.

New message bodies and newly uploaded attachments are encrypted on the server with AES-256-GCM, using versioned keys that can be rotated without affecting old ciphertext. This is server-side encryption rather than end-to-end encryption: the Worker decrypts content after permission checks, so the Cloudflare environment and the deployer holding the keys must be trusted.

Key features

  • 01Group chats and direct messages with realtime updates over WebSocket
  • 02Two-way Telegram group bridge for text, images, video, voice and files
  • 03Linking groups across separately deployed EdgeChat instances
  • 04AES-256-GCM server-side encryption for new messages and attachments, with key rotation
  • 05Invite-only accounts with permanent and temporary bans
  • 06Runs on Cloudflare Workers, D1, KV, R2 and Durable Objects, deployed via GitHub Actions

Use cases

  • A small team or community that wants a self-hosted chat without running its own server
  • Groups that already use a Telegram group and want a separate web chat entry point
  • Two organisations that need a shared group across their own chat instances
  • Developers who want an AI assistant to participate in chat rooms via WebMCP

Quick start

  1. 1

    Clone the repository

    git clone https://github.com/aozorae/Edgechat.git
  2. 2

    Enter the project folder

    cd Edgechat
  3. 3

    Install dependencies

    npm install
  4. 4

    Start the frontend-only demo (no cloud resources needed)

    npm run dev:demo

Things to know

  • Encryption is server-side, not end-to-end; Cloudflare and the deployer must be trusted.
  • Deploying the real backend requires setting up Cloudflare resources and configuration first.
  • Messages are deleted after 15 days by default unless MESSAGE_RETENTION_DAYS is set.

Topics

#chat#cloudflare-workers#self-hosted#team-chat#telegram#websocket#serverless#encryption#cloudflare#instant-messaging

FAQ

What is Edgechat?
Self-hosted team chat running on Cloudflare Workers, with realtime messaging, a two-way Telegram bridge, and server-side encrypted messages and files. EdgeChat is an open-source team chat system that runs entirely on Cloudflare. It provides group chats and direct messages, voice messages, file sharing, and one-to-one voice calls. The app and its data resources are deployed to your own Cloudflare account, and GitHub Actions handles deployment and updates, so you do not need to maintain a persistent server.
Is Edgechat free to use? What license does it have?
Edgechat is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is Edgechat still maintained?
Actively maintained. The last commit to Edgechat was on Oct 18, 2026.
What can I use Edgechat for?
A small team or community that wants a self-hosted chat without running its own server Groups that already use a Telegram group and want a separate web chat entry point Two organisations that need a shared group across their own chat instances Developers who want an AI assistant to participate in chat rooms via WebMCP
How do I install Edgechat?
Clone the repository: git clone https://github.com/aozorae/Edgechat.git Enter the project folder: cd Edgechat Install dependencies: npm install Start the frontend-only demo (no cloud resources needed): npm run dev:demo
Where can I get Edgechat?
The source code and installation instructions are on GitHub: https://github.com/aozorae/Edgechat

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects