git clone https://github.com/ArchiveRegion/mimo2codex-580.git
cd mimo2codex-580
python setup.py

English · 简体中文 · Docs site

Local proxy that lets the latest OpenAI Codex CLI / desktop talk to virtually any modern LLM. Built-in support for Xiaomi MiMo V2.5 and DeepSeek V4 Pro, plus a generic provider mechanism for any OpenAI Chat Completions-compatible (Qwen / GLM / Kimi / vLLM / Ollama / LM Studio …) or native Responses API upstream — no code changes, no re-publish. It translates Codex's Responses API ↔ upstream Chat Completions on the fly, routes per-request by the model field, and runs on 127.0.0.1.

Why: MiMo's official Codex integration only supports wire_api = "chat", which newer Codex versions hard-error on. mimo2codex sits in between, so you keep Codex on latest and it thinks it's talking to a native Responses backend. Conceptually a thin protocol shim — sibling to openrouter / claude-code-router.

• ✅ Codex CLI (wire_api = "responses") + desktop app — stay on the latest Codex.
• ✅ Multi-provider in one process — MiMo + DeepSeek + generic providers, per-request routing by the model field.
• ✅ Any OpenAI-compatible / native-Responses upstream — Qwen / GLM / Kimi / Ollama / OpenAI, declared in providers.json.
• ✅ Tool calling, web search, vision, reasoning — function & parallel tools, MCP namespace; MiMo native web_search; correct multi-turn reasoning_content round-trip.
• ✅ One-click Codex model switching from the admin webui (replaces cc-switch).
• ✅ Admin console at http://127.0.0.1:8788/admin/ — model catalog, chat logs, token stats, provider config; sqlite persistence.

Full docs (searchable, bilingual) live at https://mimodoc.chengj.online.

Getting started

• Env setup — set up all keys once; per-OS .env loader (macOS / Linux / Windows)
• Codex Enable — one-click model switching in the webui (replaces cc-switch)
• Isolated Windows Codex CLI — let Codex CLI use MiMo while Codex Desktop stays untouched

Deployment

• Docker — docker compose up -d, data persistence, multi-arch images
• Auth & multi-user — login, BYOK, OAuth, downloadable Codex config bundles

Providers

• Generic providers — any OpenAI-compatible / native-Responses upstream via providers.json
• MiniMax · SenseNova · Kimi — per-vendor compatibility notes
• Connector plugins — why Codex Desktop connectors (GitHub / Gmail / …) can't be proxied, and the fallback

Reference

• mimoskill — image gen / OCR fallback / /hatch pet generation
• Proxy & network FAQ
• Community feedback
• Tag log (changelog)

MIT — see LICENSE.