# KiaraX Coder

**Enterprise AI Development Platform by Kiara Intelligence**

[![NPM Version](https://img.shields.io/npm/v/@kiarax/coder)](https://www.npmjs.com/package/@kiarax/coder)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)

KiaraX Coder is an enterprise-grade AI development platform that brings advanced AI capabilities to your development workflow with enterprise license management and source code protection.

> [!NOTE]
> This is a commercial product requiring a valid license key. Visit [kiarax.com/pricing](https://kiarax.com/pricing) to get started.

## 🚀 Features

- **AI-Powered Development**: Advanced code generation, debugging, and optimization using KiaraX AI
- **Enterprise License Management**: Secure license validation and usage tracking
- **Multi-Platform Support**: Works on Windows, macOS, and Linux
- **Source Code Protection**: Compiled binaries protect your investment
- **Full CLI Integration**: Seamless command-line experience
- **Code Understanding & Editing**: Query and edit large codebases beyond traditional context window limits
- **Workflow Automation**: Automate operational tasks like handling pull requests and complex rebases

## 📦 Installation

### NPM (Global)
```bash
npm install -g @kiarax/coder
```

### Direct Binary Download
Download platform-specific binaries from [GitHub Releases](https://github.com/kiarax/coder/releases)

## 🔧 Quick Start

### 1. Activate License
```bash
kiarax activate KIARAX-XXXX-XXXX-XXXX-XXXX
```

### 2. Start Coding
```bash
kiarax "Build a React component for user authentication"
```

### 3. Interactive Mode
```bash
kiarax
```

## 📋 Commands

| Command | Description |
|---------|-------------|
| `kiarax activate <license>` | Activate with license key |
| `kiarax status` | Check license status and usage |
| `kiarax deactivate` | Remove license from machine |
| `kiarax help` | Show help information |

## 🏢 Enterprise Features

- **License Validation**: Secure license checking before each operation
- **Usage Tracking**: Monitor API usage and limits
- **Multi-Machine Support**: Use license across authorized devices
- **Tier-Based Limits**: Free, Pro, and Enterprise tiers available

## 🔑 Getting a License

Visit [kiarax.com/pricing](https://kiarax.com/pricing) to get your license key.

**Tier Limits:**
- **Free**: 10,000 tokens/month
- **Pro**: 100,000 tokens/month  
- **Enterprise**: 1,000,000 tokens/month

## 🛠️ Configuration

KiaraX Coder uses advanced AI models optimized for development tasks.

> ⚠️ **Notice:** <br>
> **If you are in mainland China, please go to https://bailian.console.aliyun.com/ or https://modelscope.cn/docs/model-service/API-Inference/intro to apply for your API key** <br>
> **If you are not in mainland China, please go to https://modelstudio.console.alibabacloud.com/ to apply for your API key**

If you are in mainland China, you can use Qwen3-Coder through the Alibaba Cloud bailian platform.

```bash
export OPENAI_API_KEY="your_api_key_here"
export OPENAI_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
export OPENAI_MODEL="qwen3-coder-plus"
```

If you are in mainland China, ModelScope offers 2,000 free model inference API calls per day:

```bash
export OPENAI_API_KEY="your_api_key_here"
export OPENAI_BASE_URL="https://api-inference.modelscope.cn/v1"
export OPENAI_MODEL="Qwen/Qwen3-Coder-480B-A35B-Instruct"
```

If you are not in mainland China, you can use Qwen3-Coder through the Alibaba Cloud modelstuido platform.

```bash
export OPENAI_API_KEY="your_api_key_here"
export OPENAI_BASE_URL="https://dashscope-intl.aliyuncs.com/compatible-mode/v1"
export OPENAI_MODEL="qwen3-coder-plus"
```

## Usage Examples

### Explore Codebases

```sh
cd your-project/
qwen
> Describe the main pieces of this system's architecture
```

### Code Development

```sh
> Refactor this function to improve readability and performance
```

### Automate Workflows

```sh
> Analyze git commits from the last 7 days, grouped by feature and team member
```

```sh
> Convert all images in this directory to PNG format
```

## Popular Tasks

### Understand New Codebases

```text
> What are the core business logic components?
> What security mechanisms are in place?
> How does the data flow work?
```

### Code Refactoring & Optimization

```text
> What parts of this module can be optimized?
> Help me refactor this class to follow better design patterns
> Add proper error handling and logging
```

### Documentation & Testing

```text
> Generate comprehensive JSDoc comments for this function
> Write unit tests for this component
> Create API documentation
```

## 📞 Support

- **Documentation**: [docs.kiarax.com](https://docs.kiarax.com)
- **Issues**: [GitHub Issues](https://github.com/kiarax/coder/issues)
- **Enterprise Support**: enterprise@kiarax.com

## 📄 License

Apache 2.0 License - see [LICENSE](LICENSE) file for details.

---

**Built by Kiara Intelligence** - *The Future of AI Development*
