---
## Mezon Bug Report Community
[Mezon Bug Report Community](https://mezon.ai/invite/1840696977034055680)
## high-performance, lightweight alternative to Discord
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.
### β¨ Key Features
- **π Security First** - End-to-end encryption, XSS protection, zero-knowledge architecture
- **β‘ High Performance** - Sub-millisecond response times, 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
| Use Case | Features |
| ---------------------- | ---------------------------------------------------- |
| **Gaming Communities** | Voice chat, tournaments, streaming integration |
| **Professional Teams** | Channels, file sharing, integrations, meeting tools |
| **Content Creators** | Monetization tools, community building, analytics |
| **Personal Groups** | Private spaces, family connections, secure messaging |
---
## π Quick Start
### For Users
1. **Web App**: Visit [mezon.ai](https://mezon.ai) - no installation required
2. **Desktop**: Download from [releases](https://github.com/mezonai/mezon/releases) for Windows, macOS, or Linux
3. **Mobile**: Get the app from [App Store](https://apps.apple.com/vn/app/mezon/id6502750046) or [Google Play](https://play.google.com/store/apps/details?id=com.mezon.mobile&pli=1)
### For Developers
```bash
# 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](docs/developer/SETUP.md) 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
| Platform | Requirements |
| --------------- | -------------------------------------------------------------- |
| **Web** | Modern browser (Chrome 90+, Firefox 88+, Safari 14+, Edge 90+) |
| **Desktop** | Windows 10+, macOS 10.15+, Ubuntu 18.04+ |
| **Mobile** | iOS 13.0+, Android 8.0+ (API level 26+) |
| **Development** | Node.js 18+, Yarn 1.22.4+, 4GB RAM minimum |
### Source code
| Platform | Git Repo | Status |
| ----------- | -------------------------------------------------------- | --------- |
| **Desktop** | [Desktop repo](https://github.com/mezonai/mezon-desktop) | β
Stable |
| **iOS** | [IOS repo](https://github.com/mezonai/mezon-ios) | β
Stable |
| **Android** | [Android repo](https://github.com/mezonai/mezon-android) | β
Stable |
| **Web** | [Web repo](https://github.com/mezonai/mezon) | β
Stable |
### Download Options
| Platform | Download Link | Status |
| ----------- | ----------------------------------------------------------------------------- | --------- |
| **Windows** | [Download](https://apps.microsoft.com/detail/9pf25lf1fj17) | β
Stable |
| **macOS** | [Download](https://apps.apple.com/vn/app/mezon-desktop/id6756601798) | β
Stable |
| **Linux** | [Download](https://cdn.mezon.ai/release/mezon-1.4.72-linux-amd64.deb) | β
Stable |
| **iOS** | [App Store](https://apps.apple.com/vn/app/mezon/id6502750046) | β
Stable |
| **Android** | [Google Play](https://play.google.com/store/apps/details?id=com.mezon.mobile) | β
Stable |
| **Web** | [mezon.ai](https://mezon.ai) | β
Stable |
---
## π¨βπ» Development
### π οΈ Development Setup
```bash
# 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
yarn dev:desktop # Start desktop app
# Build for production
yarn build:chat # Build web chat app
yarn build:desktop # Build desktop app
yarn build:mobile # Build mobile apps
# Code quality
yarn lint # Run linting
yarn format # Format code
```
### 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:
```bash
yarn install
```
#### 2. Retrieve Authentication Data from Dev
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](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`
#### 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 the Dev site 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 Dev 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
- **Mobile**: React Native
- **Desktop**: Electron
#### Backend & Infrastructure
- **Core**: We built a custom server using Redis, ScyllaDB, and sockets to enable real-time communication.
- **Mezon Mainnet**: [mmn](https://github.com/mezonai/mmn) - High-performance and zero free blockchain layer 1
- **Real-time**: WebSocket with binary protocol
- **Security**: E2E encryption, TLS 1.3
- **Performance**: Sub-millisecond latency, horizontal scaling
#### Development Tools
- **Testing**: Jest + Cypress
- **Linting**: ESLint + Prettier
- **CI/CD**: GitHub Actions
- **Package Manager**: Yarn
### π Getting Started
1. **Setup**: Follow the [Developer Guide](docs/developer/SETUP.md) for detailed setup instructions
2. **Architecture**: Review [Architecture docs](docs/developer/ARCHITECTURE.md) to understand the system
3. **Contribute**: Browse [open issues](https://github.com/mezonai/mezon/issues) for contribution opportunities
4. **Community**: Join our [developer community](https://mezon.ai/invite/1840696977034055680) 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](https://github.com/mezonai/mezon-bot-example) | [SDK Documentation](https://mezon.ai/docs/mezon-sdk-docs/)
## π€ Contributing
We welcome contributions from the community! Here's how you can help:
### Ways to Contribute
- π **Report Bugs**: Use our [issue tracker](https://github.com/mezonai/mezon/issues)
- π‘ **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](CONTRIBUTING.md) for detailed information about our development process, coding standards, and pull request guidelines.
---
## π Resources & Documentation
### π For Users
- [**Web App**](https://mezon.ai/chat/direct/friends) - Try Mezon instantly
- [**Community Directory**](https://mezon.ai/clans/) - Discover communities
- [**Bot/App store**](https://top.mezon.ai/) - Mezon Top Board
- [**User Guide**](docs/user-guides/GETTING_STARTED.md) - Getting started guide
### π οΈ For Developers
- [**Developer Guide**](docs/developer/SETUP.md) - Complete setup and development guide
- [**API Documentation**](https://mezon.ai/docs/mezon-sdk-docs/) - REST API and WebSocket reference
- [**Architecture Guide**](docs/developer/ARCHITECTURE.md) - System design and architecture
- [**Bot Development**](https://github.com/mezonai/mezon-bot-example) - Bot creation tutorial
### π¦ SDKs & Libraries
- [**JavaScript SDK**](https://github.com/mezonai/mezon-js) - Official JS/TS SDK
- [**Go SDK**](https://github.com/mezonai/mezon-go-sdk) - Official Go SDK
- [**Java SDK**](https://github.com/mezonai/mezon-java-sdk) - Official Java SDK
- [**Python SDK**](https://github.com/phuvinh010701/mezon-sdk-python) - Official Python SDK
- [**NestJS SDK**](https://github.com/n0xgg04/nezon) - Official NestJs SDK
- [**Mezon WebJs SDK**](https://github.com/mezonai/mezon-web-js) - SDK for channel apps integration
- [**MCP Integration**](https://github.com/mezonai/mezon-mcp) - AI-ready integration
### π Community & Support
- [**Community Hub**](https://mezon.ai/invite/1840696977034055680) - Join our official community
- [**GitHub Discussions**](https://github.com/mezonai/mezon/discussions) - Ask questions and share ideas
- [**Issue Tracker**](https://github.com/mezonai/mezon/issues) - Report bugs and request features
- [**Developer Portal**](https://mezon.ai/developers/applications) - 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](#-installation) 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](docs/TROUBLESHOOTING.md) or ask in our [community chat](https://mezon.ai/invite/1840696977034055680).
---
## π License & Legal
- **License**: [MIT License](LICENSE) - Free for personal and commercial use
- **Privacy Policy**: [mezon.ai/privacy](https://mezon.ai/privacy-policy)
- **Terms of Service**: [mezon.ai/terms](https://mezon.ai/terms-of-service)
- **Security Policy**: [SECURITY.md](SECURITY.md)
---
## π Acknowledgments
Mezon is built on top of amazing open-source technologies:
- [webrtc](https://github.com/pion/webrtc) - Pion WebRTC A pure Go implementation of the WebRTC API
- [livekit](https://livekit.io) - Livekit
- [ScyllaDB](https://www.scylladb.com) - ScyllaDB
- [Redis](https://redis.io) - Redis
- [imgproxy](https://imgproxy.net) - imgproxy
- [minio](https://min.io) - minio
- [Ory Hydra](https://www.ory.sh/hydra) - OAuth 2.0 and OpenID Connect server
- [Snowflake](https://github.com/bwmarrin/snowflake) - A very simple Twitter snowflake generator
- [React](https://reactjs.org/) - UI framework
- [Nx](https://nx.dev/) - Monorepo tooling
- And many other fantastic open-source projects
