Metadata-Version: 2.4
Name: oh-my-kimi
Version: 0.1.0
Summary: A Python-based orchestrator for Kimi Code CLI
Author-email: hao <hao@example.com>
License: MIT
Project-URL: Homepage, https://wang-h.github.io/oh-my-kimi-website/
Project-URL: Repository, https://github.com/wang-h/oh-my-kimi-python
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: typer>=0.9.0
Requires-Dist: rich>=13.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: tomlkit>=0.12.0
Requires-Dist: libtmux>=0.30.0
Requires-Dist: mcp>=1.0.0

# oh-my-kimi (Python Edition) 🐍

<p align="center">
  <em>A high-performance, Python-native orchestrator for <strong>Kimi Code CLI</strong>.</em>
</p>

> [!TIP]
> **Which edition should I use?**
> - **🐍 Python Edition (Current)**: **Recommended.** Best for AI researchers, algorithm engineers, and Python-native workflows.
> - **📦 [NPM Edition](https://github.com/wang-h/oh-my-kimi)**: Best for full-stack developers and Node.js users.

---

## Overview
This is the official Python port of the `oh-my-kimi` orchestration framework. It provides **deep integration** with the Python-based `kimi-cli` ecosystem, enabling multi-agent collaboration, advanced skill management, and automated workflows without the overhead of cross-language bridging.

## Why Python Edition?
- **Native Integration**: Seamlessly share configurations, context, and environment variables with Kimi-CLI.
- **Python Skills**: Write custom agent skills in pure Python (`main.py`) instead of just Markdown.
- **Modern Performance**: Built with `Typer`, `Rich`, and `libtmux` for a fast, beautiful terminal experience.
- **No Node.js Required**: Pure Python environment, easy to install via `pip` or `uv`.

## Core Features
- [x] **Smart Pathing**: Unified resolution for `~/.kimi` and legacy `.codex` homes.
- [x] **Instruction Overlay**: Dynamic `AGENTS.md` injection with automated **Codebase Map** generation.
- [x] **Tmux Orchestration**: One-click multi-agent team setup (`omk team`).
- [x] **Real-time HUD**: High-refresh monitoring dashboard via `rich.live`.
- [x] **MCP Infrastructure**: Python-native Model Context Protocol servers for state and memory.

## Getting Started

### Prerequisites
- Python 3.10+
- `kimi-cli` (Python version)

### Installation
```bash
# Recommended: Install using uv for speed
uv pip install -e .

# Or using standard pip
pip install -e .
```

### Usage
```bash
# Check your environment
omk info

# Launch a multi-agent team
omk team "Refactor this module into cleaner abstractions"

# Single-turn ask with project context
omk ask "How does the plugin system work?"
```

## Comparison

| Feature | Python Edition (🐍) | NPM Edition (📦) |
| --- | --- | --- |
| **Language** | Python 3.10+ | TypeScript / Rust |
| **Integration** | Native (import/env) | Subprocess / Wrapper |
| **Skill Type** | Python (.py) & Markdown | Markdown (.md) |
| **Best For** | AI/Data Scientists | Full-stack Devs |
| **CLI Framework** | Typer / Rich | Yargs / Inquirer |

## Documentation
For more guides and a full skill catalog, visit the [Official Website](https://wang-h.github.io/oh-my-kimi-website/).

## License
MIT
