sd-kimi-code


Namesd-kimi-code JSON
Version 0.1.0 PyPI version JSON
download
home_pageNone
SummaryAn open-source, Claude-Code-style terminal agent powered by Kimi AI. Interactive coding assistant with beautiful CLI.
upload_time2025-07-17 20:43:43
maintainerNone
docs_urlNone
authorNone
requires_python>=3.10
licenseMIT
keywords agent ai assistant cli coding kimi terminal
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # 🤖 Kimi Code

[![PyPI version](https://badge.fury.io/py/sd-kimi-code.svg)](https://badge.fury.io/py/sd-kimi-code)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**An open-source, Claude-Code-style terminal agent powered by Kimi AI.** 

Get an interactive coding assistant right in your terminal with beautiful CLI, tool integration, and natural language programming.

```
╭──────────────────────────────────────────────╮
│  ██╗  ██╗██╗███╗   ███╗██╗    ██████╗ ██████╗ ██████╗ ███████╗  │
│  ██║ ██╔╝██║████╗ ████║██║  ██╔════╝██╔═══██╗██╔══██╗██╔════╝  │
│  █████╔╝ ██║██╔████╔██║██║  ██║     ██║   ██║██║  ██║█████╗    │
│  ██╔═██╗ ██║██║╚██╔╝██║██║  ██║     ██║   ██║██║  ██║██╔══╝    │
│  ██║  ██╗██║██║ ╚═╝ ██║██║  ╚██████╗╚██████╔╝██████╔╝███████╗  │
│  ╚═╝  ╚═╝╚═╝╚═╝     ╚═╝╚═╝   ╚═════╝ ╚═════╝ ╚═════╝ ╚══════╝  │
╰──────────────────────────────────────────────╯

🔥 kimi > create a Python web scraper for news articles
🔥 kimi > add unit tests to my FastAPI project  
🔥 kimi > help me debug this React component
```

## ✨ Features

- 🎨 **Beautiful Interactive CLI** - Claude Code-style terminal interface
- 🤖 **Powered by Kimi AI** - Advanced language model with coding expertise
- 🛠️ **Tool Integration** - File operations, shell commands, git integration
- 💬 **Natural Language** - Just describe what you want to build
- 🚀 **Instant Setup** - One command installation and configuration
- 📁 **Context Aware** - Understands your project structure and files
- 🔄 **Streaming Responses** - Real-time AI responses as you type

## 🚀 Quick Start

### Installation

```bash
pip install sd-kimi-code
```

### Setup

1. **Get your Kimi API key** from [Moonshot AI Platform](https://platform.moonshot.cn)

2. **Configure kimi-code:**
   ```bash
   kimi init --provider kimi
   # Enter your API key when prompted
   ```

3. **Start coding!**
   ```bash
   # Interactive mode (like Claude Code)
   kimi
   
   # Or one-shot commands
   kimi run "create a Python file that calculates fibonacci numbers"
   ```

## 💡 Usage Examples

### Interactive Mode
```bash
$ kimi

🔥 kimi > create a Flask web app with user authentication
🔥 kimi > add error handling to my existing code
🔥 kimi > help me optimize this database query
🔥 kimi > exit
```

### Command Mode
```bash
# File operations
kimi run "create a README.md for my Python project"
kimi run "add type hints to all functions in src/"

# Development tasks  
kimi run "write unit tests for my calculator.py file"
kimi run "create a Dockerfile for this Node.js app"
kimi run "add logging to my FastAPI application"
```

### Built-in Commands
- `help` - Show available commands and examples
- `clear` - Clear the terminal screen  
- `exit`, `quit` - Exit interactive mode
- `config` - Show current configuration

## 🔧 Configuration

### Providers
Currently supports:
- **Kimi** (Moonshot AI) - Recommended
- **OpenAI** (GPT models) - Coming soon

### Environment Variables
```bash
export KIMI_CODE_API_KEY="your-api-key"
export KIMI_CODE_MODEL="moonshot-v1-8k"  # or moonshot-v1-32k
```

### Config File
Located at `~/.kimi-code/config.toml`:
```toml
provider = "kimi"
api_key = "your-api-key"  
model = "moonshot-v1-8k"
max_tokens = 8000
temperature = 0.0
```

## 🛠️ Available Tools

Kimi Code can:
- 📝 **Create & edit files** - Write, modify, and organize your code
- 🔍 **Read & analyze code** - Understand existing projects  
- 💻 **Run shell commands** - Execute terminal operations
- 🌳 **Browse directories** - Navigate project structures
- 🔄 **Git integration** - Commit, branch, and manage repositories
- 🐛 **Debug & test** - Help troubleshoot and write tests

## 🎯 Use Cases

- **Rapid Prototyping** - Quickly build MVPs and proof of concepts
- **Code Generation** - Create boilerplate, APIs, and complete applications  
- **Debugging Help** - Get assistance troubleshooting errors
- **Learning** - Understand new frameworks and best practices
- **Refactoring** - Improve code quality and structure
- **Documentation** - Generate README files, comments, and docs

## 📋 Requirements

- Python 3.10 or higher
- Kimi API key from [Moonshot AI](https://platform.moonshot.cn)
- Terminal with Unicode support (for best experience)

## 🤝 Contributing

We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.

1. Fork the repository
2. Create a feature branch: `git checkout -b feature-name`
3. Make your changes and add tests
4. Submit a pull request

## 📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## 🙏 Acknowledgments

- Inspired by [Claude Code](https://claude.ai) by Anthropic
- Powered by [Kimi](https://kimi.moonshot.cn) by Moonshot AI
- Built with [Rich](https://github.com/Textualize/rich) for beautiful terminal output

## 🔗 Links

- [Documentation](https://github.com/yourname/kimi-code/wiki)
- [Issues & Bug Reports](https://github.com/yourname/kimi-code/issues) 
- [Feature Requests](https://github.com/yourname/kimi-code/discussions)
- [Kimi API Documentation](https://platform.moonshot.cn/docs)

---

**Made with ❤️ for developers who love beautiful, powerful tools.**

```bash
pip install -e .              # from repo root
kimi init --provider kimi     # configure API key
kimi "add unit tests for src/utils.py"
```

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "sd-kimi-code",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": null,
    "keywords": "agent, ai, assistant, cli, coding, kimi, terminal",
    "author": null,
    "author_email": "Sambhav Dixit <indosambhav@gmail.com>",
    "download_url": "https://files.pythonhosted.org/packages/41/93/ef73b1d377798fcf9f3845b322ed150bb3ef1bc6e7bd87db768e8538856b/sd_kimi_code-0.1.0.tar.gz",
    "platform": null,
    "description": "# \ud83e\udd16 Kimi Code\n\n[![PyPI version](https://badge.fury.io/py/sd-kimi-code.svg)](https://badge.fury.io/py/sd-kimi-code)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n**An open-source, Claude-Code-style terminal agent powered by Kimi AI.** \n\nGet an interactive coding assistant right in your terminal with beautiful CLI, tool integration, and natural language programming.\n\n```\n\u256d\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256e\n\u2502  \u2588\u2588\u2557  \u2588\u2588\u2557\u2588\u2588\u2557\u2588\u2588\u2588\u2557   \u2588\u2588\u2588\u2557\u2588\u2588\u2557    \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557  \u2502\n\u2502  \u2588\u2588\u2551 \u2588\u2588\u2554\u255d\u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2557 \u2588\u2588\u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255d\u2588\u2588\u2554\u2550\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2588\u2588\u2557\u2588\u2588\u2554\u2550\u2550\u2550\u2550\u255d  \u2502\n\u2502  \u2588\u2588\u2588\u2588\u2588\u2554\u255d \u2588\u2588\u2551\u2588\u2588\u2554\u2588\u2588\u2588\u2588\u2554\u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551     \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2588\u2588\u2588\u2557    \u2502\n\u2502  \u2588\u2588\u2554\u2550\u2588\u2588\u2557 \u2588\u2588\u2551\u2588\u2588\u2551\u255a\u2588\u2588\u2554\u255d\u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551     \u2588\u2588\u2551   \u2588\u2588\u2551\u2588\u2588\u2551  \u2588\u2588\u2551\u2588\u2588\u2554\u2550\u2550\u255d    \u2502\n\u2502  \u2588\u2588\u2551  \u2588\u2588\u2557\u2588\u2588\u2551\u2588\u2588\u2551 \u255a\u2550\u255d \u2588\u2588\u2551\u2588\u2588\u2551  \u255a\u2588\u2588\u2588\u2588\u2588\u2588\u2557\u255a\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d\u2588\u2588\u2588\u2588\u2588\u2588\u2554\u255d\u2588\u2588\u2588\u2588\u2588\u2588\u2588\u2557  \u2502\n\u2502  \u255a\u2550\u255d  \u255a\u2550\u255d\u255a\u2550\u255d\u255a\u2550\u255d     \u255a\u2550\u255d\u255a\u2550\u255d   \u255a\u2550\u2550\u2550\u2550\u2550\u255d \u255a\u2550\u2550\u2550\u2550\u2550\u255d \u255a\u2550\u2550\u2550\u2550\u2550\u255d \u255a\u2550\u2550\u2550\u2550\u2550\u2550\u255d  \u2502\n\u2570\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256f\n\n\ud83d\udd25 kimi > create a Python web scraper for news articles\n\ud83d\udd25 kimi > add unit tests to my FastAPI project  \n\ud83d\udd25 kimi > help me debug this React component\n```\n\n## \u2728 Features\n\n- \ud83c\udfa8 **Beautiful Interactive CLI** - Claude Code-style terminal interface\n- \ud83e\udd16 **Powered by Kimi AI** - Advanced language model with coding expertise\n- \ud83d\udee0\ufe0f **Tool Integration** - File operations, shell commands, git integration\n- \ud83d\udcac **Natural Language** - Just describe what you want to build\n- \ud83d\ude80 **Instant Setup** - One command installation and configuration\n- \ud83d\udcc1 **Context Aware** - Understands your project structure and files\n- \ud83d\udd04 **Streaming Responses** - Real-time AI responses as you type\n\n## \ud83d\ude80 Quick Start\n\n### Installation\n\n```bash\npip install sd-kimi-code\n```\n\n### Setup\n\n1. **Get your Kimi API key** from [Moonshot AI Platform](https://platform.moonshot.cn)\n\n2. **Configure kimi-code:**\n   ```bash\n   kimi init --provider kimi\n   # Enter your API key when prompted\n   ```\n\n3. **Start coding!**\n   ```bash\n   # Interactive mode (like Claude Code)\n   kimi\n   \n   # Or one-shot commands\n   kimi run \"create a Python file that calculates fibonacci numbers\"\n   ```\n\n## \ud83d\udca1 Usage Examples\n\n### Interactive Mode\n```bash\n$ kimi\n\n\ud83d\udd25 kimi > create a Flask web app with user authentication\n\ud83d\udd25 kimi > add error handling to my existing code\n\ud83d\udd25 kimi > help me optimize this database query\n\ud83d\udd25 kimi > exit\n```\n\n### Command Mode\n```bash\n# File operations\nkimi run \"create a README.md for my Python project\"\nkimi run \"add type hints to all functions in src/\"\n\n# Development tasks  \nkimi run \"write unit tests for my calculator.py file\"\nkimi run \"create a Dockerfile for this Node.js app\"\nkimi run \"add logging to my FastAPI application\"\n```\n\n### Built-in Commands\n- `help` - Show available commands and examples\n- `clear` - Clear the terminal screen  \n- `exit`, `quit` - Exit interactive mode\n- `config` - Show current configuration\n\n## \ud83d\udd27 Configuration\n\n### Providers\nCurrently supports:\n- **Kimi** (Moonshot AI) - Recommended\n- **OpenAI** (GPT models) - Coming soon\n\n### Environment Variables\n```bash\nexport KIMI_CODE_API_KEY=\"your-api-key\"\nexport KIMI_CODE_MODEL=\"moonshot-v1-8k\"  # or moonshot-v1-32k\n```\n\n### Config File\nLocated at `~/.kimi-code/config.toml`:\n```toml\nprovider = \"kimi\"\napi_key = \"your-api-key\"  \nmodel = \"moonshot-v1-8k\"\nmax_tokens = 8000\ntemperature = 0.0\n```\n\n## \ud83d\udee0\ufe0f Available Tools\n\nKimi Code can:\n- \ud83d\udcdd **Create & edit files** - Write, modify, and organize your code\n- \ud83d\udd0d **Read & analyze code** - Understand existing projects  \n- \ud83d\udcbb **Run shell commands** - Execute terminal operations\n- \ud83c\udf33 **Browse directories** - Navigate project structures\n- \ud83d\udd04 **Git integration** - Commit, branch, and manage repositories\n- \ud83d\udc1b **Debug & test** - Help troubleshoot and write tests\n\n## \ud83c\udfaf Use Cases\n\n- **Rapid Prototyping** - Quickly build MVPs and proof of concepts\n- **Code Generation** - Create boilerplate, APIs, and complete applications  \n- **Debugging Help** - Get assistance troubleshooting errors\n- **Learning** - Understand new frameworks and best practices\n- **Refactoring** - Improve code quality and structure\n- **Documentation** - Generate README files, comments, and docs\n\n## \ud83d\udccb Requirements\n\n- Python 3.10 or higher\n- Kimi API key from [Moonshot AI](https://platform.moonshot.cn)\n- Terminal with Unicode support (for best experience)\n\n## \ud83e\udd1d Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature-name`\n3. Make your changes and add tests\n4. Submit a pull request\n\n## \ud83d\udcc4 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## \ud83d\ude4f Acknowledgments\n\n- Inspired by [Claude Code](https://claude.ai) by Anthropic\n- Powered by [Kimi](https://kimi.moonshot.cn) by Moonshot AI\n- Built with [Rich](https://github.com/Textualize/rich) for beautiful terminal output\n\n## \ud83d\udd17 Links\n\n- [Documentation](https://github.com/yourname/kimi-code/wiki)\n- [Issues & Bug Reports](https://github.com/yourname/kimi-code/issues) \n- [Feature Requests](https://github.com/yourname/kimi-code/discussions)\n- [Kimi API Documentation](https://platform.moonshot.cn/docs)\n\n---\n\n**Made with \u2764\ufe0f for developers who love beautiful, powerful tools.**\n\n```bash\npip install -e .              # from repo root\nkimi init --provider kimi     # configure API key\nkimi \"add unit tests for src/utils.py\"\n```\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "An open-source, Claude-Code-style terminal agent powered by Kimi AI. Interactive coding assistant with beautiful CLI.",
    "version": "0.1.0",
    "project_urls": {
        "Homepage": "https://github.com/yourname/kimi-code",
        "Issues": "https://github.com/yourname/kimi-code/issues",
        "Repository": "https://github.com/yourname/kimi-code"
    },
    "split_keywords": [
        "agent",
        " ai",
        " assistant",
        " cli",
        " coding",
        " kimi",
        " terminal"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "a42892f65a266266ad23a33430888afd1a10e471e2e2dc00514fa55f879f3f5c",
                "md5": "77c3b65cae8bf45b5f76edc137e545ff",
                "sha256": "4f18337145db44810a849e1fc5354d718dec83de0147758a78deb39abcc5b01a"
            },
            "downloads": -1,
            "filename": "sd_kimi_code-0.1.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "77c3b65cae8bf45b5f76edc137e545ff",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 21851,
            "upload_time": "2025-07-17T20:43:41",
            "upload_time_iso_8601": "2025-07-17T20:43:41.090736Z",
            "url": "https://files.pythonhosted.org/packages/a4/28/92f65a266266ad23a33430888afd1a10e471e2e2dc00514fa55f879f3f5c/sd_kimi_code-0.1.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "4193ef73b1d377798fcf9f3845b322ed150bb3ef1bc6e7bd87db768e8538856b",
                "md5": "4eab6f6528f16b61f4d2af41f13cc2bb",
                "sha256": "b226821aebfe8fd07ab248965e17beeabc10bf381ed20f9a761a22d6d85f25cc"
            },
            "downloads": -1,
            "filename": "sd_kimi_code-0.1.0.tar.gz",
            "has_sig": false,
            "md5_digest": "4eab6f6528f16b61f4d2af41f13cc2bb",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 40782,
            "upload_time": "2025-07-17T20:43:43",
            "upload_time_iso_8601": "2025-07-17T20:43:43.107149Z",
            "url": "https://files.pythonhosted.org/packages/41/93/ef73b1d377798fcf9f3845b322ed150bb3ef1bc6e7bd87db768e8538856b/sd_kimi_code-0.1.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-07-17 20:43:43",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "yourname",
    "github_project": "kimi-code",
    "github_not_found": true,
    "lcname": "sd-kimi-code"
}
        
Elapsed time: 1.50401s