{"name":"OpenMausBot: Your Open-Source AI Bot Team in a Chat App","description":"OpenMausBot is an open-source desktop application that provides an alternative to Grok Bot, allowing users to manage a team of AI agents within a chat interface. It emphasizes local-first operation, bringing your own agents, and providing each bot with its own virtual machine or access to your computer. This project enables powerful AI interactions with privacy and control at its core.","github":"https://github.com/milind-soni/OpenMausBot","url":"https://osrepos.com/repo/milind-soni-openmausbot","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/milind-soni-openmausbot","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/milind-soni-openmausbot.md","json":"https://osrepos.com/repo/milind-soni-openmausbot.json","topics":["TypeScript","AI","Bots","Desktop App","Open Source","Electron","Productivity","Agentic AI"],"keywords":["TypeScript","AI","Bots","Desktop App","Open Source","Electron","Productivity","Agentic AI"],"stars":null,"summary":"OpenMausBot is an open-source desktop application that provides an alternative to Grok Bot, allowing users to manage a team of AI agents within a chat interface. It emphasizes local-first operation, bringing your own agents, and providing each bot with its own virtual machine or access to your computer. This project enables powerful AI interactions with privacy and control at its core.","content":"## Introduction\n\nOpenMausBot is an open-source desktop application that offers a robust alternative to Grok Bot, allowing users to manage a team of AI agents within an intuitive chat interface. Inspired by the idea of \"AI as a messaging app,\" this project rebuilds the experience to be local-first, bring your own agents, and operate on the platforms you already own. With OpenMausBot, every bot in your roster is a real AI agent, complete with its own personality, model, computing environment, and connected apps, enabling you to interact with them like contacts.\n\n## Why Use and Key Features\n\nOpenMausBot is designed to transform how you interact with AI agents, offering unprecedented control and flexibility.\n\n### Why OpenMausBot?\n\n*   **Bring your own agents:** Bots run on the `claude`, `codex`, and `grok` CLIs installed on your own machine, using your existing logins and subscriptions, with no new accounts or proxies needed.\n*   **Local-first:** A small local harness server (`127.0.0.1`) owns every agent process. Transcripts, keys, and events live in `~/.openmausbot`, ensuring your data remains private and under your control.\n*   **Agents with hands:** Each bot can use a cloud Linux desktop, an isolated Local VM, or, with explicit opt-in and where platform safety is certified, your own computer. Additionally, they can access over 500 apps through Composio.\n\n### Key Features:\n\n*   **Pick a brain per bot:** A model picker allows you to choose between Claude, Codex, and Grok models, with the ability to switch a bot's model mid-conversation.\n*   **Every bot gets a computer:** The \"Computer\" panel enables the bot's cloud desktop to spin up, with a live screen preview of its work. You can even take over in your browser or point the bot at your local machine.\n*   **Bots ask before they act:** Shell commands, file edits, and questions surface as inline cards, allowing you to \"Allow,\" \"Deny,\" or answer in chat, ensuring you maintain control over your agents' actions.\n*   **Connected apps:** A one-click marketplace over Composio Sessions offers integration with Gmail, Slack, GitHub, Notion, Linear, and hundreds more. Authenticate once, and all your bots can use them as tools.\n*   **Manage bots like chats:** A familiar messaging app interface lets you pin, mark unread, edit profiles, duplicate, hide, or delete bots, treating them like contacts.\n*   **Channels for every context:** Keep your projects, work, and personal conversations separate in dedicated channels, each with its own transcript, shared instructions, and editable bot roster.\n*   **Install a complete team from one Markdown file:** Browse outcome-driven teams on [BotMRR](https://botmrr.io){:target=\"_blank\"} and add them to OpenMausBot with a click, importing bots, channels, and routines.\n*   **Bots that talk back:** Enable text-to-speech functionality to hear bot replies, or initiate a \"call\" for an interactive conversation, where the bot listens, describes its actions while working, and asks for approvals aloud.\n\n## Installation\n\nGetting started with OpenMausBot is straightforward, whether you prefer a pre-built installation or building from source.\n\n### Released Builds\n\nThe harness server is embedded in the released builds, so no separate server setup is required.\n\n*   **macOS (Apple silicon):** Download [OpenMausBot.dmg](https://github.com/milind-soni/OpenMausBot/releases/latest/download/OpenMausBot.dmg){:target=\"_blank\"}. Drag it to Applications and open.\n*   **macOS (Intel):** Download [OpenMausBot-intel.dmg](https://github.com/milind-soni/OpenMausBot/releases/latest/download/OpenMausBot-intel.dmg){:target=\"_blank\"}. The same app, but built for Intel Macs.\n*   **Windows (x64):** Download [OpenMausBot-setup.exe](https://github.com/milind-soni/OpenMausBot/releases/latest/download/OpenMausBot-setup.exe){:target=\"_blank\"}. Run the installer. You might need to click \"More info ? Run anyway\" due to an unknown publisher.\n*   **Ubuntu 24.04 (x64):** Download [OpenMausBot-amd64.deb](https://github.com/milind-soni/OpenMausBot/releases/latest/download/OpenMausBot-amd64.deb){:target=\"_blank\"} (recommended) or [OpenMausBot.AppImage](https://github.com/milind-soni/OpenMausBot/releases/latest/download/OpenMausBot.AppImage){:target=\"_blank\"}.\n\n### From Source\n\nFor developers or those who prefer to build from source:\n\nsh\ngit clone https://github.com/milind-soni/OpenMausBot && cd OpenMausBot\npnpm install\n\npnpm dev:server    # harness server ? 127.0.0.1:8799\npnpm dev           # app ? http://127.0.0.1:5199\npnpm dev:desktop   # Electron shell; keep the two commands above running\n\n\n**Requirements:** macOS, Windows, or Ubuntu 24.04 x64, Node 24+, pnpm, and at least one agent CLI (claude, codex, or grok) installed and logged in.\n\n## Examples\n\nOpenMausBot offers flexibility to get started quickly or set up a robust service environment.\n\n### Quick Start via Terminal\n\nYou can run OpenMausBot directly from your terminal, with or without a global installation:\n\nsh\nnpm install -g openmausbot\nopenmausbot\n\n\nAlternatively, use `npx openmausbot` for a global-install-free execution. The first launch will guide you through initial setup, including AI access and optional phone connection. To reconfigure without resetting bots or conversations, use `openmausbot setup`.\n\n### Server Deployment\n\nFor a background service on a VPS or an always-on computer, use `npx openmausbot serve` with explicit remote options, such as `--tunnel` for a managed public address, `--tailscale` for your tailnet, or a Docker stack for your own domain. Refer to the [deployment documentation](https://github.com/milind-soni/OpenMausBot/blob/main/docs/deploy-vps.md){:target=\"_blank\"} for more details.\n\n## Links\n\n*   **GitHub Repository:** [https://github.com/milind-soni/OpenMausBot](https://github.com/milind-soni/OpenMausBot){:target=\"_blank\"}\n*   **Latest Releases:** [https://github.com/milind-soni/OpenMausBot/releases/latest](https://github.com/milind-soni/OpenMausBot/releases/latest){:target=\"_blank\"}\n*   **Support the Project:** [Support OpenMausBot via Polar](https://buy.polar.sh/polar_cl_bbnfWFUrWONIF4HnUpZf1p0if0eUYg3HeXct73b48Yg){:target=\"_blank\"}\n*   **BotMRR (Bot Teams):** [https://botmrr.io](https://botmrr.io){:target=\"_blank\"}\n*   **Box API Key Guide:** [https://docs.ascii.dev/box/api-keys](https://docs.ascii.dev/box/api-keys){:target=\"_blank\"}\n*   **Composio Setup Guide:** [https://github.com/milind-soni/OpenMausBot/blob/main/docs/composio.md](https://github.com/milind-soni/OpenMausBot/blob/main/docs/composio.md){:target=\"_blank\"}","metrics":{"detailViews":1,"githubClicks":0},"dates":{"published":null,"modified":"2026-09-20T19:23:25.000Z"}}