<div align="center"> <p> <img src="./images/mach1.png" alt="Mentra Mach 1" height="80" style="margin: 0 15px;" /> <img src="./mobile/assets/glasses/g1.png" alt="Even Realities G1" height="80" style="margin: 0 15px;" /> <img src="./images/MentraLiveFinal.png" alt="Mentra Live" height="80" style="margin: 0 15px;" /> </p> <h1>MentraOS</h1> <h3>The open source operating system for smart glasses</h3> <p> <a href="https://mentra.glass">Website</a> • <a href="https://docs.mentra.glass">Documentation</a> • <a href="https://console.mentra.glass">Developer Console</a> • <a href="https://apps.mentra.glass">Mentra Store</a> </p> <p> <img src="https://img.shields.io/github/contributors/TeamOpenSmartGlasses/DiscussPlusPlus" alt="Contributors" /> <img src="https://img.shields.io/github/license/TeamOpenSmartGlasses/DiscussPlusPlus" alt="License" /> <img src="https://img.shields.io/github/stars/TeamOpenSmartGlasses/DiscussPlusPlus?style=social" alt="GitHub Stars" /> <img src="https://img.shields.io/github/v/release/TeamOpenSmartGlasses/DiscussPlusPlus" alt="GitHub Release Version" /> <img src="https://img.shields.io/github/last-commit/TeamOpenSmartGlasses/DiscussPlusPlus" alt="Last Updated" /> </p> </div> <div align="center"> <a href="https://apps.apple.com/us/app/mentra-the-smart-glasses-app/id6747363193"> <img src="./images/AppStoreBadge.png" alt="Download on the App Store" width="180"> </a> <a href="https://play.google.com/store/apps/details?id=com.mentra.mentra"> <img src="./images/GooglePlayBadge.png" alt="Get it on Google Play" width="180"> </a> </div> <div align="center"> <h4>Nightly Builds</h4> <p> <a href="https://github.com/TeamOpenSmartGlasses/DiscussPlusPlus/releases/download/nightly-builds/mobile-latest.apk"> <img src="https://img.shields.io/badge/Mobile_App-Download_APK-blue?style=for-the-badge&logo=android" alt="Download Mobile APK" /> </a> <a href="https://github.com/TeamOpenSmartGlasses/DiscussPlusPlus/releases/download/nightly-builds/asg-latest.apk"> <img src="https://img.shields.io/badge/ASG_Client-Download_APK-green?style=for-the-badge&logo=android" alt="Download ASG APK" /> </a> </p> </div>

Supported Smart Glasses

Works with Even Realities G1, Mentra Mach 1, Mentra Live. See smart glasses compatibility list here.

Apps on Mentra Store

The Mentra Store already has a ton of useful apps that real users are running everyday. Here are some apps already published by developers on the Mentra Store:

<div align="center"> <table border="0" cellspacing="0" cellpadding="0" style="border: 0 !important; border-collapse: collapse;"> <tbody> <tr style="border: 0 !important; background: transparent;"> <td align="center" style="border: 0 !important; padding: 15px; background: transparent;"> <a href="https://apps.mentra.glass/package/com.augmentos.livecaptions" style="text-decoration: none; color: inherit;"> <img src="https://appstore.augmentos.org/app-icons/captions.png" alt="Live Captions" width="80" style="border-radius: 18px;" /> <br /><b>Captions</b> </a> </td> <td align="center" style="border: 0 !important; padding: 15px; background: transparent;"> <a href="https://apps.mentra.glass/package/com.mentra.link" style="text-decoration: none; color: inherit;"> <img src="https://appstore.augmentos.org/app-icons/mentra-link.png" alt="Link" width="80" style="border-radius: 18px;" /> <br /><b>Link</b> </a> </td> <td align="center" style="border: 0 !important; padding: 15px; background: transparent;"> <a href="https://apps.mentra.glass/package/com.mentra.merge" style="text-decoration: none; color: inherit;"> <img src="https://appstore.augmentos.org/app-icons/mentra-merge.png" alt="Merge" width="80" style="border-radius: 18px;" /> <br /><b>Merge</b> </a> </td> <td align="center" style="border: 0 !important; padding: 15px; background: transparent;"> <a href="https://apps.mentra.glass/package/com.mentra.notes" style="text-decoration: none; color: inherit;"> <img src="./images/MentraNotes.png" alt="Notes" width="80" style="border-radius: 18px;" /> <br /><b>Notes</b> </a> </td> </tr> <tr style="border: 0 !important; background: transparent;"> <td align="center" style="border: 0 !important; padding: 15px; background: transparent;"> <a href="https://apps.mentra.glass/package/com.mentra.calendarreminder" style="text-decoration: none; color: inherit;"> <img src="https://imagedelivery.net/nrc8B2Lk8UIoyW7fY8uHVg/32095bee-2bbd-4564-4777-4f99fcf73700/square" alt="Calendar Reminder" width="80" style="border-radius: 18px;" /> <br /><b>Calendar</b> </a> </td> <td align="center" style="border: 0 !important; padding: 15px; background: transparent;"> <a href="https://apps.mentra.glass/package/com.mentra.dash" style="text-decoration: none; color: inherit;"> <img src="./images/MentraDash.png" alt="Dash" width="80" style="border-radius: 18px;" /> <br /><b>Dash</b> </a> </td> <td align="center" style="border: 0 !important; padding: 15px; background: transparent;"> <a href="https://apps.mentra.glass/package/com.mentra.translation" style="text-decoration: none; color: inherit;"> <img src="https://imagedelivery.net/nrc8B2Lk8UIoyW7fY8uHVg/b5891997-3e90-4bdc-398a-834e3318b900/square" alt="Live Translation" width="80" style="border-radius: 18px;" /> <br /><b>Translation</b> </a> </td> <td align="center" style="border: 0 !important; padding: 15px; background: transparent;"> <a href="https://apps.mentra.glass" style="text-decoration: none; color: inherit;"> <img src="./images/MentraLogoSquareRound.png" alt="Mentra Store" width="80" style="border-radius: 18px;" /> <br /><b>See All</b> </a> </td> </tr> </tbody> </table> </div>

Write Once, Run on Any Smart Glasses

MentraOS is how developers build smart glasses apps. We handle the pairing, connection, data streaming, and cross-compatibility, so you can focus on creating amazing apps. Every component is 100% open source (MIT license).

Why Build with MentraOS?

Cross Compatibility: Your app runs on any pair of smart glasses
Speed: TypeScript SDK means you're making apps in minutes, not months
Control: Access smart glasses I/O - displays, microphones, cameras, speakers
Distribution: Get your app in front of everyone using smart glasses

Development Setup

Quick Start

For detailed setup instructions, see CLAUDE.md in the repository root.

Recommended Development Environment (Mobile)

Platform: macOS or Linux (Windows has known issues with this project)
Node.js: Version 20.x (use nvm for version management)
Package Manager: bun (preferred) or npm
Android: Android Studio with Java SDK 17
iOS: Xcode (macOS only)
Cloud: Docker and Docker Compose

Key Commands

Mobile App (mobile/):

bun install
bun start              # Start dev server
bun android            # Run on Android
bun ios                # Run on iOS
bun test               # Run tests

Cloud Backend (cloud/):

bun install
bun run dev            # Start Docker dev environment
bun run test           # Run tests

For complete build instructions, testing guidelines, and code style requirements, see CLAUDE.md.

MentraOS Community

The MentraOS Community is a group of developers, companies, and users dedicated to ensuring the next personal computer is open, cross-compatible, and user-controlled. That's why we're building MentraOS.

To get involved, join the MentraOS Community Discord server.

Contact

Have questions or ideas? We'd love to hear from you!

Email: team@mentra.glass
Discord: Join our community
Twitter: Follow @mentralabs

Contributing

MentraOS is made by a community and we welcome PRs. Here's the Contributors Guide: docs.mentra.glass/os-devs/contributing

Looking for ways to contribute? We mark issues we'd love the community to help with using the "Help Wanted" tag. Check them out here: Help Wanted Issues

MentraOS

Install / Use

README