Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/mezonai/mezon

Mezon is a new way to communicate with your team. It's faster, better organized, better for WFH.
https://github.com/mezonai/mezon

bot-framework chat chat-application communication community

Last synced: about 2 months ago
JSON representation

Mezon is a new way to communicate with your team. It's faster, better organized, better for WFH.

Awesome Lists containing this project

README 

          


  
Mezon


  

  


    The Live, Work, and Play Platform – the best Discord alternative.

  



  


    Latest Release

    License

    GitHub Stars

    Issues

    Forks

  



  


    Try Live

    Join Community

    Contributions Welcome

  





---



## Mezon Bug Report Community



[Mezon Bug Report Community](https://mezon.ai/invite/1840696977034055680)



## The Live, Work, and Play Platform the best Discord Alternative



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.





  Mezon Platform Overview




### ✨ 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://mezon.ai) or [Google Play](https://mezon.ai)



### 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                     |



### 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.61-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

│   ├── desktop/       # Electron desktop app

│   ├── mobile/        # React Native mobile app

│   └── 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)

-   **Terms of Service**: [mezon.ai/terms](https://mezon.ai/terms)

-   **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





  


    Made with ❤️ by the Mezon Team


    Connecting communities worldwide

  


  

  


    ⭐ Star us on GitHub •

    💬 Join our community •

    🐛 Report an issue