Ethora — SDK Monorepo

Chat, AI and messaging SDK platform. Add real-time messaging, AI bots, and backend services to your app in minutes.

This repository serves as the SDK monorepo — a single place to discover, clone, and navigate all Ethora SDKs, tools, and sample apps. Each component lives in its own focused repository, linked here as git submodules.

Ecosystem

Folder	Repository	Description	Status
sdk-reactjs/	ethora-chat-component	React.js chat SDK — embed chat in any web app	Active
sdk-reactnative/	ethora-chat-component-rn	React Native chat SDK (iOS & Android)	Active
sdk-android/	ethora-sdk-android	Native Android SDK (Kotlin)	Active
sdk-swift/	ethora-sdk-swift	Native iOS SDK (Swift)	Active
sdk-wordpress/	ethora-wp-plugin	WordPress plugin — no-code chat widget	Active
app-reactjs/	ethora-app-reactjs	Full web app (React.js) — App Builder frontend	Active
playground/	ethora-sdk-playground	SDK testing & demo playground	Active
backend-integration/	ethora-sdk-backend-integration	Backend integration examples	Active
mcp-cli/	ethora-mcp-cli	MCP CLI for IDE/agent integration	Active
rag-demos/	rag_demos	RAG pipeline demos & examples	Active
bots/	ethora-bots	Bot framework (XMPP, LLM, automation)	Active
setup/	ethora-setup	CLI setup tool — npx @ethora/setup	Active
api/	(inline)	REST API documentation (Swagger/OpenAPI)	Reference
—	ethora-app-react-native	React Native app (iOS & Android)	Legacy
—	site_crawler	Website crawler for RAG ingestion	Active

Getting Started

Clone with all submodules

git clone --recurse-submodules https://github.com/dappros/ethora.git
cd ethora

If you already cloned without --recurse-submodules:

git submodule update --init --recursive

Automatic submodule bumps

This repo can update its submodule pointers automatically via .github/workflows/bump-submodules.yml.

Behavior:

• runs every 6 hours on weekdays and on manual dispatch
• updates each submodule to the latest commit on its remote default branch
• commits pointer bumps directly into main

Set up credentials (recommended)

npx @ethora/setup

This will create an account, set up an app, and generate config files for your target SDK. You can also connect to a self-hosted server.

Quick paths

Add chat to a website (fastest):

cd sdk-reactjs
npm install
# See sdk-reactjs/README.md for embedding instructions

Add chat to a React Native app:

cd sdk-reactnative
npm install
# See sdk-reactnative/README.md

Native Android SDK:

cd sdk-android
# See sdk-android/README.md for Gradle setup

Native iOS SDK:

cd sdk-swift
# See sdk-swift/README.md for Swift Package Manager setup

WordPress (no code): Install the plugin from sdk-wordpress/ or see ethora-wp-plugin.

Connect via MCP (IDE/AI agent):

cd mcp-cli
npm install
# See mcp-cli/README.md

Default backend

Sign up for a free account at app.ethora.com to get API credentials. The SDKs connect to Ethora Cloud by default. Self-hosted and dedicated server options are available for enterprise customers.

What you can build

• Chat / Messaging — 1:1 and group chat, push notifications, audio/video calls
• AI Assistants — LLM-powered bots, RAG pipelines, prompt engineering
• Backend-as-a-Service — Users, files, push notifications out of the box
• Digital Wallets — ERC-20/721/1155 tokens, documents, digital assets
• Gamification — Coins/points, referrals, daily bonuses, collectibles

Architecture

Your App
  └── Ethora SDK (React.js / React Native / Android / Swift / WordPress)
        └── Ethora Platform API (REST + XMPP)
              ├── Chat (Ejabberd + custom services)
              ├── AI (LLM bots, RAG)
              ├── Users & Auth (SSO, JWT)
              ├── Files & Storage (S3/IPFS)
              ├── Push Notifications (FCM/APNs)
              └── Blockchain (EVM, optional)

Hosting options: Cloud (free tier) | Self-hosted (AWS Marketplace / Docker) | Dedicated server

Contributing

We welcome issues, discussions, and PRs across the ecosystem. Each submodule has its own issue tracker — use the relevant repository for bug reports and feature requests.

• Open an issue for cross-cutting concerns
• Use Discussions for Q&A
• Follow conventional commit messages

Contact

• Website: https://ethora.com/
• Try Free: https://app.ethora.com/register
• Twitter/X: https://x.com/EthoraOfficial
• LinkedIn: https://www.linkedin.com/company/ethora-official/

License

AGPL and MIT licenses. Commercial licenses available from Dappros.

---

Previous README content (archive)

Project Updates (Archive)

4 Dec 2024 — New platform UI released

Finally our new version of the overall platform UI is released. This affects the whole web version including chat component and Admin Screens. We hope you like the new look of Ethora and this inspires you to build your fascinating projects with Ethora engine! Both old and new UI are going to remain available for you to use for a few months after which we will sunset the old version. More details in our Community Forum: https://forum.ethora.com/topic/38-new-version-soft-launch/#comment-48

11 Oct 2024 — NPM: Ethora Chat Component

We released the Ethora Chat Component npm package — launch a chat room in minutes without digging into a mono-repo. https://www.npmjs.com/package/@ethora/chat-component

3 Sep 2024 — Web version redesign

We're updating our web design — new login/sign-in screens and Admin dashboard. Follow updates: https://forum.ethora.com/forum/16-updates-and-announcements/

5 Jul 2024 — Chat Component alpha

Alpha of the chat component released. It combines Ethora's platform features with simple embedding. More: https://forum.ethora.com/topic/9-ethora-nmp-package-chat-component-alpha-version/#comment-9

11 Oct 2023 — Architecture & design plans

Architecture review & refactoring; forthcoming design updates (mobile first, then web). Video by @CodeEater21 on building iOS/Android with Ethora: https://www.youtube.com/watch?v=pKEMcxJb5HM Self-hosted options via AWS Marketplace / Docker Hub planned.

Screenshots

React Native — Standard UI (new design)

React Native — Standard UI (old version)

Branded (customized) UI

App Builder

The fastest way to get your app running:

1. Customize name, logo, colors
2. Launch your web app on your subdomain
3. Generate React Native codebases for iOS & Android

Sign up: https://app.ethora.com/register

5-minute demo (widget)

Add an AI chat to any site:

Chat Bots

Ethora uses XMPP for chat. Connect bots in Python, Node.js, etc.

• ChatGPT bot — integrate OpenAI/LLMs for topic-specialized assistants

• Translate bot — interpreter bot (EN-ES)

Gamification, Referrals & Rewards

• Coin (ERC-20) for project economy
• Sign-up bonus (100 Coins by default)
• Daily check-in (5 Coins)
• Referrals (25 Coins to both users)

Threads

Keep busy chats tidy with thread replies.

Core Features

• iOS, Android, Web
• Your own name, branding, token/coin name
• SSO (Social Sign On) via Gmail, Facebook, Apple or email
• AI Bots with LLM, RAG, prompt engineering features
• Each user gets a digital assets wallet + cryptographic keypair
• Coins (ERC-20) & NFTs (ERC-721/1155)
• Crypto-likes (tip tokens to messages)
• Rooms & spaces, QR/public-key invites
• Profiles, push, audio/video calls

Authors & Governance

Ethora & its server infrastructure have been developed since 2018 by Dappros and DeepX. The team is led by Taras Filatov, a Ukrainian-born and UK-based tech entrepreneur.

Backend: Dappros Platform API & DeepX RTC: EVM chain + API/cache (Node.js, Kafka, Redis, MongoDB), IPFS/S3 storage, and XMPP Ejabberd messaging with custom services (Erlang, Mnesia, MySQL, Cassandra).

Commercial model:

• Client-side: free, open-source (closed-source commercial license available)
• Server-side: freemium (generous free tier + paid SLA for businesses)