Kimi-Dev AI Coder 🤖

An AI-powered software development system that can autonomously build complex software projects using the Kimi-Dev-72B model.

Features

🚀 Core Capabilities

1. 🎯 Autonomous Project Builder ⭐ NEW!

   • Build complete projects from a single prompt
   • AI asks clarifying questions
   • Step-by-step implementation with feedback
   • Fully automated or interactive mode

2. File Operations

   • Read files with automatic encoding detection
   • Regex search across multiple files
   • Smart file writing with structure validation
   • Find functions, classes, and imports

3. Code Generation

   • Language-specific templates (Python, JavaScript, Java, Go, Rust, etc.)
   • Framework-aware project structures
   • Best practices enforcement
   • Automatic documentation generation

4. Testing & Debugging

   • Multi-framework test runner
   • AI-powered debugging and error analysis
   • Test generation and validation
   • Code improvement suggestions

5. Project Planning

   • Step-by-step project breakdown
   • Dependency analysis
   • Progress tracking
   • Requirement analysis

6. RAG System (Coming Soon)

   • Vector database for learning
   • Error/solution storage
   • Context retrieval
   • Learn from past projects

7. Plugin System (Coming Soon)

   • Extensible architecture
   • Custom tool integration
   • Community plugins

8. Workspace Management

   • Project organization
   • Multi-project support
   • Metadata tracking
   • Configuration management

9. Smart Prompts

   • Dynamic template selection
   • Context-aware generation
   • Few-shot examples

10. Dual-AI Architecture (Coming Soon)

    • Planner AI for high-level design
    • Executor AI (Kimi-Dev) for implementation
    • Feedback loop for continuous improvement

11. Configuration System

    • .kimi-dev folder for project configs
    • Best practices per framework
    • Custom instructions

Installation

1. Clone the repository:

git clone <repository-url>
cd kimi-coder

2. Activate the virtual environment:

source coder/bin/activate

3. Install dependencies:

pip install -r requirements.txt

Usage

🌟 Build Complete Project (Single Command!)

# Interactive mode - AI asks clarifying questions
python main.py build "Create a REST API for a todo app with user authentication"

# Fully automated mode
python main.py build "Build a blog platform with comments and likes" --auto

# More examples
python main.py build "Create a React dashboard with charts and real-time data"
python main.py build "Build a Python web scraper for e-commerce sites"
python main.py build "Make a Discord bot with slash commands"

The AI will:

1. Ask clarifying questions about tech stack, features, and requirements
2. Create a detailed plan and show it for your approval
3. Implement step-by-step - models, routes, tests, documentation
4. Request feedback after each major step
5. Complete the entire project ready for you to use!

Create a New Project

python main.py create my-project --language python --framework flask

Generate Code

python main.py generate "Create a user authentication system" --language python --output auth.py

Search Code

python main.py search ./src "def.*user" --context

Debug Code

python main.py debug app.py "AttributeError: 'NoneType' object has no attribute 'name'" --fix

Analyze Codebase

python main.py analyze ./src --language python

Interactive Mode

python main.py interactive

List Projects

python main.py list-projects

Project Structure

kimi-coder/
├── src/
│   ├── ai/              # AI model integration
│   │   ├── kimi_client.py
│   │   ├── planner_client.py
│   │   └── context_manager.py
│   ├── code_gen/        # Code generation engine
│   │   ├── template_manager.py
│   │   ├── code_generator.py
│   │   └── best_practices.py
│   ├── file_ops/        # File operations
│   │   ├── file_reader.py
│   │   ├── file_writer.py
│   │   └── file_search.py
│   ├── testing/         # Test execution & feedback
│   ├── planner/         # Project planning
│   ├── rag/             # RAG system
│   ├── plugins/         # Plugin system
│   ├── workspace/       # Workspace management
│   ├── prompts/         # Prompt templates
│   └── core/            # Core orchestrator
├── .kimi-dev/          # Configuration & instructions
├── projects/           # Created projects
├── tests/              # Test suite
├── main.py             # CLI entry point
└── requirements.txt    # Dependencies

Supported Languages & Frameworks

Languages

• Python
• JavaScript/TypeScript
• Java
• Go
• Rust
• C/C++
• Ruby
• PHP

Frameworks

• Python: Flask, Django, FastAPI
• JavaScript: Express, React, Next.js
• Java: Spring Boot
• And more...

Best Practices

The system enforces best practices for each language:

• Python: PEP 8, type hints, docstrings
• JavaScript: Airbnb style guide, JSDoc
• Java: Google Java Style, Javadoc
• TypeScript: Strict typing, TSDoc
• Go: Effective Go guidelines
• Rust: Rust style guide, rustdoc

Configuration

Each project has a .kimi-dev/config.json file:

{
  "name": "my-project",
  "language": "python",
  "framework": "flask",
  "description": "My awesome project",
  "created_at": "2025-12-20T...",
  "version": "0.1.0"
}

Advanced Usage

Custom Templates

Add custom code templates:

from src.code_gen.template_manager import TemplateManager

tm = TemplateManager()
tm.add_custom_template(
    "python", 
    "my_template", 
    "class $class_name:\n    pass"
)

Plugin Development

Create custom plugins in src/plugins/:

class MyPlugin:
    def __init__(self):
        self.name = "my_plugin"
    
    def execute(self, context):
        # Your plugin logic
        pass

Development Roadmap

• File operations module
• Code generation engine
• Template system
• Best practices enforcement
• Workspace management
• CLI interface
• Complete test runner
• RAG system with ChromaDB
• Plugin architecture
• Dual-AI system
• Prompt optimization
• Web interface
• VS Code extension

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests
5. Submit a pull request

License

MIT License - see LICENSE file for details

Credits

Powered by:

• Kimi-Dev-72B model by Moonshot AI
• Transformers by Hugging Face
• Various open-source tools and libraries

Support

For issues, questions, or suggestions:

• Open an issue on GitHub
• Check the documentation in .kimi-dev/
• Join our community (coming soon)

---

Built with ❤️ using AI