🧠 CodeMind — AI-Powered Programming Assistant

Write • Debug • Explain • Optimize — all through natural conversation with the
Xiaomi MiMo-V2.5-Pro (309B MoE, 100K context) — the #1 open-source model globally.

Features • Tech Stack • Quick Start • Architecture • API • Screenshots • Milestones • Contributing

---

🌟 Overview

CodeMind is a full-stack AI programming assistant that connects developers with the cutting-edge Xiaomi MiMo-V2.5-Pro model through an elegant, modern web interface. Built as part of the MiMo Orbit 100T Token Creator Incentive Program, CodeMind demonstrates the full potential of open-source AI in software development.

Why CodeMind?

Challenge	CodeMind Solution
Context switching between editor and AI chat	Integrated chat + code panel in one interface
Generic AI assistants with no code focus	Purpose-built for programming with 14 language modes
Complex setup requirements	One-command start: pip install && python run.py
Limited context windows	Full 100K token native support from MiMo-V2.5-Pro
No streaming feedback	Real-time SSE streaming for instant responses

---

✨ Features

🎯 Core Capabilities

Feature	Description
💬 Intelligent Chat	Conversational code generation with context awareness
📖 Code Explanation	Detailed breakdown of complex code in plain language
🔍 Code Review	AI-powered review spotting bugs, security issues, and optimizations
⚡ Code Optimization	Performance analysis with concrete improvement suggestions
🔄 Multi-Language	Supports Python, JS, TS, Java, C++, C#, Go, Rust, Ruby, Swift, Kotlin, SQL, and more

🎨 User Experience

• Dark/Light Theme — Eye-friendly dark mode with elegant glassmorphism, toggle to light theme
• Streaming Responses — Real-time token-by-token output with zero latency perception
• Smart Suggestions — One-click prompt chips for common programming tasks
• Conversation Management — Clear history, context-aware follow-ups
• Responsive Design — Perfectly optimized for desktop and tablet

🔌 Integration

• Xiaomi MiMo API — Direct integration with MiMo-V2.5-Pro's chat completion and streaming endpoints
• OpenAPI Compatible — Fully documented API at /docs (auto-generated by FastAPI)
• RESTful Design — Clean, predictable API endpoints with Pydantic validation

---

🛠 Tech Stack

┌─────────────────────────────────────────────────────┐
│                   CodeMind                           │
├──────────────────────┬──────────────────────────────┤
│     Frontend         │         Backend               │
├──────────────────────┼──────────────────────────────┤
│  • HTML5             │  • Python 3.11+               │
│  • CSS3 (Glassmorphism) │  • FastAPI (Async)          │
│  • Vanilla JS (ES6+) │  • Uvicorn (ASGI Server)      │
│  • Google Fonts      │  • httpx (Async HTTP Client)  │
│  • Responsive Design │  • Pydantic (Data Validation) │
│  • Dark/Light Theme  │  • SSE (Server-Sent Events)   │
└──────────────────────┴──────────────────────────────┘
                         │
                         ▼
              ┌──────────────────┐
              │  Xiaomi MiMo API  │
              │  MiMo-V2.5-Pro   │
              │  (309B MoE)       │
              └──────────────────┘

Why This Stack?

• FastAPI — Async-native, automatic OpenAPI docs, best-in-class performance
• Vanilla JS — Zero dependencies, lightning-fast load times, full control
• Glassmorphism CSS — Modern aesthetic that screams quality and polish
• SSE Streaming — Lighter than WebSockets for one-way AI responses, native browser support

---

🚀 Quick Start

Prerequisites

• Python 3.11 or later
• pip (Python package manager)
• A MiMo API key from the Orbit 100T Plan

1. Clone & Install

git clone https://github.com/YOUR_USERNAME/codemind.git
cd codemind
pip install -r requirements.txt

2. Configure

cp .env.example .env
# Edit .env and add your MiMo API key:
#   MIMO_API_KEY=sk-your-key-here

💡 Get your free API key at 100t.xiaomimimo.com — part of the MiMo Orbit 100 Trillion Token Program.

3. Launch

python run.py

Your CodeMind instance is now running at http://localhost:8000 🎉

4. Start Coding!

Open your browser, type a prompt like "Write a Python function to parse JSON from an API response", and watch CodeMind generate production-ready code in real-time.

---

🏗 Architecture

                                  ┌─────────────────┐
                                  │    Browser       │
                                  │  (HTML/CSS/JS)   │
                                  └────────┬────────┘
                                           │
                                    HTTP / SSE
                                           │
                                  ┌────────▼────────┐
                                  │   FastAPI Server │
                                  │  (async Python)  │
                                  └────────┬────────┘
                                           │
                                  ┌────────▼────────┐
                                  │   MiMo API Client│
                                  │  (httpx Async)   │
                                  └────────┬────────┘
                                           │
                                  ┌────────▼────────┐
                                  │  Xiaomi MiMo API │
                                  │ MiMo-V2.5-Pro    │
                                  │ (309B MoE Model) │
                                  └─────────────────┘

Data Flow

1. User types a programming question in the chat interface
2. Frontend sends the message via POST to /api/chat with stream: true
3. FastAPI constructs a system prompt + user message and forwards to the MiMo API
4. MiMo API streams tokens back through Server-Sent Events
5. Frontend renders each token in real-time with full Markdown + syntax highlighting

Key Design Decisions

Decision	Rationale
Async everywhere	Non-blocking I/O for concurrent request handling and streaming
Server-Sent Events	Lighter than WebSockets, native browser EventSource support, auto-reconnect
Separate frontend/backend	Clean separation of concerns, easy to swap either layer
Pydantic validation	Type-safe API contracts with automatic error messages
No frontend framework	Zero build step, instant loading, maximum performance

---

📡 API Reference

All endpoints are automatically documented at http://localhost:8000/docs (Swagger UI).

Method	Endpoint	Description
GET	/	Serves the frontend application
GET	/api/health	Health check + MiMo API status
POST	/api/chat	Chat completion (supports streaming)
POST	/api/explain	Explain a piece of code
POST	/api/review	Review code for bugs and improvements
GET	/api/models	List available MiMo models

Example: Chat Streaming

import httpx
import json

response = httpx.post(
    "http://localhost:8000/api/chat",
    json={
        "messages": [
            {"role": "user", "content": "Write a binary search in Python"}
        ],
        "stream": True,
        "temperature": 0.7,
        "max_tokens": 4096,
    },
)

for line in response.iter_lines():
    if line.startswith("data: ") and line != "data: [DONE]":
        chunk = json.loads(line[6:])
        print(chunk["content"], end="")

---

📸 Screenshots

Screenshots will be added after deployment. The application features:

View	Description
Home	Elegant dark-themed welcome screen with suggestion chips
Chat	Real-time streaming code generation with syntax-highlighted output
Code Review	Detailed AI-powered code analysis with actionable suggestions
Dark/Light	Toggle between eye-friendly dark mode and clean light mode

---

🏆 Milestones

This project was built as part of the Xiaomi MiMo Orbit 100T Token Creator Incentive Program.

gantt
    title CodeMind Development Timeline
    dateFormat  YYYY-MM-DD
    section Phase 1
    Project Planning & Design      :2026-05-20, 2d
    Backend Development           :2026-05-22, 2d
    Frontend Development          :2026-05-23, 2d
    section Phase 2
    MiMo API Integration          :2026-05-24, 1d
    Testing & Polish              :2026-05-24, 1d
    GitHub Launch                 :2026-05-25, 1d

Loading

Impact & Vision

• 🎯 Target: Highest tier of the MiMo Orbit 100T Incentive Program
• 🌍 Scope: Global developers seeking an open-source AI coding companion
• 🔮 Future: Extend to VSCode extension, CLI tool, and team collaboration features

---

📂 Project Structure

codemind/
├── backend/
│   ├── __init__.py
│   ├── config.py           # Environment & API configuration
│   ├── main.py             # FastAPI application & endpoints
│   └── mimoclient.py       # MiMo API client (sync + streaming)
├── frontend/
│   ├── index.html           # Main SPA application
│   ├── css/
│   │   └── style.css        # Glassmorphism UI with dark/light themes
│   └── js/
│       └── app.js           # Frontend logic, streaming, Markdown render
├── .env.example             # Environment template
├── .gitignore
├── README.md                # ← You are here
├── requirements.txt         # Python dependencies
└── run.py                   # Development server entry point

---

🤝 Contributing

Contributions are what make the open-source community an amazing place to learn and create. Any contributions you make are greatly appreciated!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

📄 License

Distributed under the MIT License. See LICENSE for more information.

---

🙏 Acknowledgments

• Xiaomi MiMo Team — For creating the world-class MiMo-V2.5-Pro model and the Orbit 100T Token Incentive Program
• 罗福莉 — For leading the MiMo-V2.5 series development
• Open Source Community — For making AI accessible to all

---

Made with ❤️ for the MiMo Orbit 100T Token Creator Incentive Program
_{Powered by Xiaomi MiMo-V2.5-Pro · 309B MoE · 100K Context · MIT Licensed}

---

📝 中文说明

CodeMind — 基于小米 MiMo-V2.5-Pro 模型的 AI 编程助手

CodeMind 是一款全栈 AI 编程助手，通过优雅的现代化界面，将开发者与全球顶级开源模型 小米 MiMo-V2.5-Pro（3090亿参数 MoE 架构）连接起来。本项目作为 小米 MiMo Orbit 百万亿 Token 创造者激励计划 的参赛作品，充分展示了开源 AI 在软件开发中的巨大潜力。

核心功能

• 💬 智能对话 — 自然语言生成生产级代码
• 📖 代码解释 — 深入浅出地解析复杂代码逻辑
• 🔍 代码审查 — AI 驱动的 Bug 检测和优化建议
• ⚡ 性能优化 — 针对性的代码性能分析

快速启动

git clone https://github.com/YOUR_USERNAME/codemind.git
cd codemind
pip install -r requirements.txt
# 编辑 .env 文件，填入你的 MiMo API Key
python run.py

访问 http://localhost:8000 即可开始使用！

💡 在 100t.xiaomimimo.com 申请免费 API Key，参与百万亿 Token 激励计划！