Mezon

Mezon Bug Report Community

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 — a C WebRTC SFU, a C11 native media engine, IO Uring and a binary data plane — instead of stacking generic HTTP and WebRTC middleware.

• 🔒 Security First - End-to-end encryption, XSS protection, zero-knowledge architecture
• ⚡ High Performance - Native C path: mezon-sfu + libmezia + 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

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

# Clone the 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.

• 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

• 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

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

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

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

# Clone the 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)
yarn dev:mobile        # Start mobile development

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

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

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

yarn install

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

1. Navigate to: https://dev-mezon.nccsoft.vn
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://dev-mezon.nccsoft.vn.
6. Locate and copy the values for the following keys:

• persist:auth
• mezon_session

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 the Dev site into the Value column.

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 Dev session active.

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

• Framework: React 18 with TypeScript
• State Management: Redux Toolkit + RTK Query
• Styling: Tailwind CSS
• Build Tool: Nx Monorepo with Webpack
• Mobile: Native app mezon-ios, mezon-android
• Desktop: Rust Native mezon-desktop repository

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: Binary Mezon-Proto over raw QUIC — C data plane (L1 process cache + Valkey), Go control plane over Unix sockets. Schemas: 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

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

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

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

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

• 🐛 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

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.

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

• Developer Guide - Complete setup and development guide
• API Documentation - REST API and WebSocket reference
• Architecture Guide - System design and architecture
• Bot Development - Bot creation tutorial

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

• 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

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: MIT License - Free for personal and commercial use
• Privacy Policy: mezon.ai/privacy
• Terms of Service: mezon.ai/terms
• Security Policy: SECURITY.md

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

• 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