mobius

<p align="right"> <a href="./README.md"><strong>English</strong></a> · <a href="./README.zh.md"><strong>简体中文</strong></a> </p>

<div align="center">

<img src="https://serve.nutshellai.cn/publish/auto/readme/mobius-logo.svg" alt="" height="42" valign="middle" /> Mobius

<h3> The first self-evolving open-source Agent OS<br /> One system to connect your team, AI agents, devices, and compute </h3>

<p align="center"> <a href="https://github.com/nutshellai-tech/mobius/stargazers"><img alt="Stars" src="https://img.shields.io/github/stars/nutshellai-tech/mobius?style=for-the-badge" /></a> <a href="https://github.com/nutshellai-tech/mobius"><img alt="Status" src="https://img.shields.io/badge/status-evolving-orange?style=for-the-badge" /></a> <a href="https://mobius.nutshellai.cn/"><img alt="Website" src="https://img.shields.io/badge/website-000000?style=for-the-badge&logo=About.me&logoColor=white" /></a> <a href="https://nutshellai-tech.github.io/mobius/en/"><img alt="Docs" src="https://img.shields.io/badge/docs-000000?style=for-the-badge&logo=readthedocs&logoColor=white" /></a> </p>

</div>

<p align="center"> <img src="https://serve.nutshellai.cn/publish/auto/readme/github-cover-v1.png" alt="Mobius GitHub cover" width="100%" /> </p>

Building a perfect AI system once and for all is like finding the end of a Mobius strip — impossible by design.

Mobius is the world's first self-evolving open-source Agent OS. Not a fixed toolbox — a growing productivity system that connects projects, teams, models, devices, compute, and apps into one traceable workspace.

News

2026-08-09

• Windows one-key install: a single PowerShell command installs the Mobius TUI on a fresh Windows machine.

2026-08-02

• Easy Mode: an optional clutter-free layout (cross-project recent sessions + JSONL + floating input). First-time users choose between Easy and Normal mode and can switch anytime.
• TUI released: connect to Mobius from any terminal with the TUI, and use Mobius the way you use Codex.

2026-07-26

• Search improvements: results stream in via SSE with case/whole-word matching; clicking a result jumps to the exact JSONL card.

2026-07-14

• Code Conversation v2 workspace mode: a 3-pane layout (file browser + built-in CodeMirror editor with syntax highlighting and in-place saving + chat).

Self-Evolving

Mobius rewrites itself from your input. Send a change request, a screenshot, or a reference link — Mobius turns them into real code, UI, plugins, or workflow updates, without interrupting your work. Each iteration replaces a plank on the Ship of Theseus, quietly in the background.

<p align="center"> <img src="https://serve.nutshellai.cn/publish/auto/readme/can-do-agent-os.gif" alt="Self-evolving Agent OS demo" width="480" /> </p>

View self-evolution examples

Serve Every Scenario and Project

• Serve Every Scenario (toggle the most convienient interface, for all possible scenarios) <p align="center"> <img src="https://github.com/user-attachments/assets/4c948e53-5c8e-4ae5-8eb3-d3ca035908c9" alt="Self-evolving Agent OS demo" width="480" /> </p>

• Manage All Projects (project overview, where you can overwatch all agents working for you) <p align="center"> <img src="https://github.com/user-attachments/assets/7868ef41-068f-4316-ae6b-b17561a119ac" alt="Self-evolving Agent OS demo" width="480" /> </p>

Auto Research

Mobius orchestrates multiple agents into an autonomous research pipeline — reading papers, extracting methods, running experiments, and surfacing results. A research goal becomes a multi-agent system, not a single Q&A.

<p align="center"> <img src="https://serve.nutshellai.cn/publish/auto/readme/can-do-research.gif" alt="Auto Research demo" width="480" /> </p>

XiaoMo

XiaoMo is the natural-language interface to the entire system. Talk to it: create projects, split tasks, launch agents, track progress. Anything clickable, XiaoMo can do. Things the UI cannot do, XiaoMo handles too. Voice input, multi-device (Web, PC, Mobile), configurable reminders.

<p align="center"> <img src="https://serve.nutshellai.cn/publish/auto/readme/xiaomo.jpg" alt="XiaoMo assistant interface" width="720" /> </p>

On the web. Zero install — open a browser on any device and the full Mobius workspace is ready instantly.

<p align="center"> <img src="https://serve.nutshellai.cn/publish/auto/readme/xiaomo-app.jpg" alt="XiaoMo on mobile" width="720" /> </p>

On your phone. XiaoMo goes wherever you go — chat with your agents, track progress, and approve decisions from anywhere. The iOS and Android apps are fully available now.

<p align="center"> <img src="https://serve.nutshellai.cn/publish/auto/readme/xiaomo-desktop-v2.png" alt="XiaoMo desktop app" width="720" /> </p>

On your desktop. A native app that turns your PC into a Mobius workstation — read and write local project files directly, enroll this machine as a controllable node, and run multi-tab workflows. Available now on Windows, macOS, and Linux.

The demos on this page were produced by XiaoMo itself, with zero human participation in recording.

Any Model, Any Agent

Mobius is model-agnostic. GPT, Claude, GLM-5.2, Codex — all serve as execution engines inside the same project. Choose by task type, cost, or performance.

Connect Everything

Mobius schedules browsers, terminals, GPU clusters, embedded boards, cloud servers, and workstations — all inside the same task network.

Reach your resources through SSH, AIMUX, and controllable proxies:

<p align="center"> <img src="https://github.com/user-attachments/assets/cd5ef0ba-1d38-4017-bf8a-e7b93d17fca0" alt="Team collaboration demo" width="480" /> </p>

Team Collaboration

Human members, AI agents, tasks, and deliverables in one view. Leads see who is doing what, where each agent is, what needs confirmation, and where risks exist — no more fragmented communication.

<p align="center"> <img src="https://serve.nutshellai.cn/publish/auto/readme/can-do-team-collab.gif" alt="Team collaboration demo" width="480" /> </p>

Self-Incubating Extensions

Mobius ships with built-in extensions and grows new ones from your needs — financial dashboards, PPT generators, research workbenches, live portals. Each extension comes with a frontend, backend handler, data directory, and invocation entry, ready to keep evolving.

<p align="center"> <img src="https://serve.nutshellai.cn/publish/auto/readme/can-do-extensions.gif" alt="Extensions demo" width="480" /> </p>

<table> <tr> <td width="50%"> <strong>Immersive Web Experiences</strong><br /> _{Turn visual ideas into runnable extension apps.}<br /> <img src="https://serve.nutshellai.cn/publish/auto/readme/extension-matrix-rounded.png" alt="Matrix-style extension" /> </td> <td width="50%"> <strong>Financial News Wall</strong><br /> _{Track live market narratives.}<br /> <img src="https://serve.nutshellai.cn/publish/auto/readme/extension-finance-news-wall-rounded.png" alt="Financial news wall" /> </td> </tr> <tr> <td width="50%"> <strong>World Cup Portal</strong><br /> _{Data-rich sports portal.}<br /> <img src="https://serve.nutshellai.cn/publish/auto/readme/extension-world-cup-rounded.png" alt="World Cup extension" /> </td> <td width="50%"> <strong>PPT Maker</strong><br /> _{Presentations from topics and materials.}<br /> <img src="https://serve.nutshellai.cn/publish/auto/readme/extension-ppt-maker-rounded.png" alt="PPT maker extension" /> </td> </tr> </table>

Quick Start

Full deployment guide at Docs.

Containers (recommended)

# 1. Clone the repo (tip: fork first, then clone — after self-evolution you can commit directly to your own repo)
git clone https://github.com/nutshellai-tech/mobius.git && cd mobius

# 2. Generate config (random keys/passwords; you may configure manually to skip this)
python3 conf_prepare.py --docker && python3 conf_check.py --docker

# 3. Build the images (the base image is environment only, no code)
docker build -t mobius-system-base:latest -f deploy/Dockerfile .
docker build -t mobius-system-exe:latest .

# 4. Launch
docker compose up

Direct (Linux / macOS)

# 1. Install prerequisites (tmux, git, etc.)
sudo apt install tmux python3 git curl proxychains openssh-server build-essential

# 2. Install coding agents (either works; installing both is recommended)
npm install -g @anthropic-ai/claude-code @openai/codex

# 3. Clone the repo (tip: fork first, then clone — after self-evolution you can commit directly to your own repo)
git clone https://github.com/nutshellai-tech/mobius.git && cd mobius

# 4. Generate and check config (copies .env.default to .env with random passwords)
python3 conf_prepare.py && python3 conf_check.py

# 5. Install dependencies (frontend + backend)
cd ./mobius && npm install && cd ./frontend && npm install && cd ../..

# 6. Run
python3 start.py

Roadmap

What we are building next:

• Mobile App — XiaoMo and full Agent control on iOS and Android
• Desktop App — a native connector that brings PC devices (Windows, macOS, Linux) into Mobius
• Extension Market — discover, share, and install community-built extensions
• i18n & Multi-language — localize the interface and documentation into more languages

Contribution

Issues, plugins, docs, bug reports, use cases — all welcome. If you believe AI systems should evolve instead of being static tools, join us.

<p align="center"> <a href="https://github.com/nutshellai-tech/mobius">GitHub</a> · <a href="https://mobius.nutshellai.cn/">Website</a> · <a href="https://nutshellai-tech.github.io/mobius/en/">Docs</a> </p>