---

Mezon Bug Report Community

Mezon Bug Report Community

High-performance, lightweight real-time platform for communities.

Mezon is a Live, Work, and Play platform. It’s perfect for gaming and chilling with friends, or even building a global community. Customize your own space to talk, play, and hang out. Mezon also delivers enterprise-grade performance with sub-millisecond response times and support for millions of concurrent connections.

That performance comes from owning the hot path end to end: high-performance native Android and iOS clients — not hybrid solutions — a Rust desktop app that renders its UI directly on the GPU, and a high-performance server stack written in C, built on a custom WebRTC SFU, a C11 native media engine, io_uring, and a binary data plane, instead of stacking generic HTTP and WebRTC middleware.

✨ Key Features

• 🔒 Security First - End-to-end encryption, XSS protection, zero-knowledge architecture
• ⚡ High Performance - Native C path: mezon-sfu + libmeziaa + mezon-proto-server (io uring). Sub-millisecond responses, millions of concurrent connections
• 🌐 Cross-Platform - Web, Desktop (Windows/macOS/Linux), Mobile (iOS/Android)
• 🤖 AI-Powered - Built-in content moderation, real-time translation, meeting summaries
• 🔧 Extensible - Custom bots, 100+ integrations, API-first design
• 💰 Creator Economy - Built-in monetization, premium memberships, token rewards

🎯 Use Cases

---

🚀 Quick Start

For Users

1. Web App: Visit mezon.ai - no installation required
2. Desktop: Download from mezon-desktop releases for Windows, macOS, or Linux
3. Mobile: Get the app from App Store or Google Play

For Developers

This repository is the web client (Nx/React monorepo). Native clients live in separate repos:

• mezon-desktop — Rust/GPUI desktop app
• mezon-ios — native iOS app
• mezon-android — native Android app

# Clone the web repository
git clone https://github.com/mezonai/mezon.git
cd mezon

# Install dependencies
yarn install

# Start development server
yarn dev:chat

The application will be available at http://localhost:4200/

📖 Need help? Check out our Developer Guide for detailed setup instructions.

---

🌟 Core Features

💬 Communication

• Rich Text Messaging - Markdown support, threads, reactions, file sharing up to 500MB
• Voice & Video - Crystal-clear HD calls supporting up to 1000 users
• Screen Sharing - Built-in recording and streaming capabilities

🛡️ Security & Privacy

• End-to-End Encryption - All messages, voice, and video communications
• Zero-Knowledge Architecture - Client-side encryption, secure binary sockets
• XSS Protection - Safe message rendering and content validation

🎯 Organization & Management

• Advanced Permissions - Custom roles with granular permission controls
• Smart Notifications - AI-powered filtering and priority management
• Event Scheduling - Built-in calendar with RSVP system

🤖 AI-Powered Features

• Content Moderation - Automated safety and community management
• Real-time Translation - Support for 100+ languages
• Meeting Intelligence - Auto-generated summaries and transcription

🔧 Integration & Extensibility

• API-First Design - Comprehensive REST and WebSocket APIs
• Bot Framework - Extensible platform with SDK support
• Third-party Integrations - 100+ tools and custom webhooks

---

📦 Installation

System Requirements

Source code

Download Options

---

👨‍💻 Development

🛠️ Development Setup

# Clone the web repository
git clone https://github.com/mezonai/mezon.git
cd mezon

# Install dependencies
yarn install

# Available development commands
yarn dev:chat          # Start chat app (port 4200)
yarn dev:admin         # Start admin dashboard (port 4200)

# Build for production
yarn build:chat        # Build web chat app

# Code quality
yarn lint              # Run linting
yarn format           # Format code

For native clients, follow the setup guides in mezon-desktop, mezon-ios, and mezon-android.

Local Development Setup Guide

1. Install Dependencies

Open your terminal in the project's root directory and run the following command to install the necessary packages:

yarn install

2. Retrieve Authentication Data from Production (mezon.ai)

To access protected data and features on your local machine, you need to copy your session tokens from the production environment:

1. Navigate to: https://mezon.ai
2. Log in with your credentials.
3. Open Developer Tools (Press F12 or Right-click > Inspect).
4. Go to the Application tab.
5. In the left sidebar, expand Local Storage and select https://mezon.ai.
6. Locate and copy the values for the following keys:

• persist:auth
• mezon_session

3. Configure Localhost Storage

Once your local server is running (typically at http://localhost:4200):

1. Open your Localhost URL in the browser.
2. Open Developer Tools (F12) > Application tab > Local Storage.
3. Manually add or edit the keys persist:auth and mezon_session.
4. Paste the corresponding values you copied from mezon.ai into the Value column.

4. Finalize

Refresh your local browser tab to apply the authentication state:

• Press F5 or Cmd/Ctrl + R.

You should now be logged into the local environment with your mezon.ai session active.

---

📁 Project Structure

mezon/
├── apps/              # Applications
│   ├── chat/          # Main web chat application
│   ├── admin/         # Admin dashboard
│   └── discover/      # Community discovery app
├── libs/              # Shared libraries
│   ├── components/    # Reusable UI components
│   ├── store/         # State management (Redux)
│   ├── transport/     # API & WebSocket clients
│   ├── core/          # Business logic
│   └── ui/            # Design system
└── docs/              # Documentation

🔧 Technology Stack

Frontend

• Framework: React 18 with TypeScript
• State Management: Redux Toolkit + RTK Query
• Styling: Tailwind CSS
• Build Tool: Nx Monorepo with Webpack
• iOS (separate repo): Native Swift client — mezon-ios
• Android (separate repo): Native Kotlin client — mezon-android
• Desktop (separate repo): Native Rust/GPUI client — mezon-desktop

Backend & Infrastructure

Mezon owns the hot path in C so chat, voice, and data stay off generic HTTP/WebRTC stacks.

• Core: Custom real-time server on Valkey, ScyllaDB, and io_uring
• mezon-sfu: C WebRTC SFU for HD meetings and large rooms — lock-free per-room workers, zero-copy io_uring fan-out, DTLS/SRTP, VP9/AV1/VP8, TWCC/GCC + SVC
• libmezia (native media engine): C11 client engine, wire-compatible with mezon-sfu — lock-minimal Opus voice (~24 kbit/s) and hardware H.264, no PeerConnection tax on mobile
• mezon-proto-server: the high-performance socket server handles protobuf compliance which is defined at mezon-protocol
• Mezon Mainnet: mmn — high-performance, zero-fee L1
• Real-time: WebSocket / TCP Abridged with binary payload; Mezon-Proto for the high-QPS data path
• Security: E2E encryption, TLS 1.3 (SFU: DTLS + SRTP)
• Performance: Sub-millisecond latency, millions of concurrent connections, horizontal scaling

Why this stack is fast

Development Tools

• Testing: Jest + Cypress
• Linting: ESLint + Prettier
• CI/CD: GitHub Actions
• Package Manager: Yarn

📚 Getting Started

1. Setup: Follow the Developer Guide for detailed setup instructions
2. Architecture: Review Architecture docs to understand the system
3. Contribute: Browse open issues for contribution opportunities
4. Community: Join our developer community for support and discussions

🔌 Extensibility

Bot Development

• Build powerful bots using our official SDKs
• Automate workflows and community management
• Access comprehensive APIs for custom integrations

Custom Themes

• Create custom themes and UI modifications
• Brand customization for communities
• Personalized user interfaces

API Integration

• REST API and WebSocket support
• Custom webhooks and third-party integrations
• Extensive documentation and examples

🔗 Resources: Bot Example | SDK Documentation

🤝 Contributing

We welcome contributions from the community! Here's how you can help:

Ways to Contribute

• 🐛 Report Bugs: Use our issue tracker
• 💡 Feature Requests: Suggest new features and improvements
• 💻 Code Contributions: Submit pull requests for bug fixes and features
• 📚 Documentation: Help improve our docs and guides
• 🌍 Translation: Help translate Mezon to more languages

Development Process

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes and add tests
4. Ensure all tests pass (yarn test)
5. Submit a pull request

📋 Guidelines: Please read our Contributing Guide for detailed information about our development process, coding standards, and pull request guidelines.

---

📚 Resources & Documentation

🚀 For Users

• Web App - Try Mezon instantly
• Community Directory - Discover communities
• Bot/App store - Mezon Top Board
• User Guide - Getting started guide

🛠️ For Developers

• Developer Guide - Complete setup and development guide (web)
• API Documentation - REST API and WebSocket reference
• Architecture Guide - System design and architecture
• Bot Development - Bot creation tutorial
• Desktop · iOS · Android - Native clients

📦 SDKs & Libraries

• JavaScript SDK - Official JS/TS SDK
• Go SDK - Official Go SDK
• Java SDK - Official Java SDK
• Python SDK - Official Python SDK
• .NET SDK - Official .NET SDK
• NestJS SDK - Official NestJs SDK
• Mezon WebJs SDK - SDK for channel apps integration
• MCP Integration - AI-ready integration

🌐 Community & Support

• Community Hub - Join our official community
• GitHub Discussions - Ask questions and share ideas
• Issue Tracker - Report bugs and request features
• Developer Portal - Build applications on Mezon

---

🔧 Troubleshooting

Common Issues

Installation Problems

• Ensure Node.js 18+ and Yarn 1.22.4+ are installed
• Clear node_modules and reinstall: rm -rf node_modules && yarn install
• Check system requirements for your platform

Development Issues

• Port conflicts: Change port in project configuration
• Build failures: Run yarn lint and yarn format to fix code issues
• WebSocket connection issues: Check firewall and proxy settings

Performance Issues

• Enable hardware acceleration in browser settings
• Close unnecessary applications to free up system resources
• Update to the latest version for performance improvements

🆘 Need Help? Visit our troubleshooting guide or ask in our community chat.

---

📄 License & Legal

• License: MIT License - Free for personal and commercial use
• Privacy Policy: mezon.ai/privacy
• Terms of Service: mezon.ai/terms
• Security Policy: SECURITY.md

---

🙏 Acknowledgments

Mezon is built on top of amazing open-source technologies:

• webrtc - Pion WebRTC A pure Go implementation of the WebRTC API
• liburing - io_uring for zero-copy I/O in mezon-sfu and mezon-proto-server
• BoringSSL - TLS / DTLS
• libsrtp - SRTP media protection
• Opus - Voice codec used by libmezia
• ScyllaDB - ScyllaDB
• Valkey / Redis - Cache and real-time state
• imgproxy - imgproxy
• minio - minio
• Ory Hydra - OAuth 2.0 and OpenID Connect server