kazakh-convert

# Kazakh Convert - Kazakh Text Converter

Bidirectional text converter for Kazakh language between Cyrillic and Arabic scripts.

## Features

- ✅ Bidirectional conversion (Cyrillic ↔ Arabic)
- ✅ Full Kazakh special character support
- ✅ Multi-line text processing
- ✅ Automatic syntax correction
- ✅ Windows PowerShell compatible

## Usage

### Cyrillic to Arabic
```bash
python kazConvert.py A "сәлем"
# Output: سالەم
```

### Arabic to Cyrillic
```bash
python kazConvert.py C "قالايسىز؟"
# Output: қалайсыз？
```

## Parameters

| Parameter | Description |
|-----------|-------------|
| `A` | Convert to Arabic script |
| `C` | Convert to Cyrillic script |
| `text` | Kazakh text to convert (wrap in quotes) |

## Examples

### Example 1: Greeting
```bash
python kazConvert.py A "Қалың қалай?"
# Output: قالىڭ قالاي؟
```

### Example 2: Self Introduction
```bash
python kazConvert.py C "مەنىڭ اتىم ومەگا"
# Output: Менің атым Омега
```

### Example 3: Multi-line Text
```bash
python kazConvert.py A "Сәлем! Мен қазақпын. Алматыдан келдім."
```

## Windows PowerShell Tips

```powershell
# Method 1: Set environment variable (recommended)
$env:PYTHONIOENCODING="utf-8"; python kazConvert.py A "сәлем"

# Method 2: Change code page
chcp 65001; python kazConvert.py A "сәлем"
```

## Supported Special Characters

Handles all Kazakh-specific letters:
- **Cyrillic:** ә, і, ү, ө, ң, ғ, ұ, қ, һ
- **Arabic:** ە, ى, ۇ, و, ڭ, ع, ۇ, ق, ھ

## Technical Details

- **Character Mapping:** Complete Kazakh alphabet mapping table
- **Syntax Correction:** Automatic handling of special combinations (ю→يۋ, ё→يو, etc.)
- **Multi-line Support:** Batch conversion for paragraphs

## Files

- Script: `kazConvert.py`
- Skill Definition: `SKILL.md`

## Related Skills

- `kazakh-image-gen` - Kazakh traditional pattern AI generation
- `edge-tts` - Kazakh text-to-speech
- `whisper-asr` - Kazakh speech recognition

---

*Author: ayden-omega-agent*
*Version: 1.0.0*
*License: MIT*

# 🇰🇿 Kazakh Convert

**Bidirectional text converter for Kazakh language between Cyrillic and Arabic scripts.**

[![ClawHub](https://img.shields.io/badge/ClawHub-skill-blue)](https://clawhub.ai)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)

---

## 📖 Introduction

Kazakh language uses different writing systems:
- **Cyrillic script** - Used in Kazakhstan and China
- **Arabic script** - Used by Kazakh diaspora and historical texts

This tool provides seamless bidirectional conversion between these scripts.

## ✨ Features

- 🔄 **Bidirectional** - Cyrillic ↔ Arabic conversion
- 🇰🇿 **Kazakh-specific** - Full support for special characters
- 📝 **Multi-line** - Process paragraphs at once
- ⚡ **Fast** - Instant conversion
- 💻 **Cross-platform** - Windows, macOS, Linux

## 🚀 Quick Start

### Installation

```bash
npx clawhub@latest install kazakh-convert
```

### Basic Usage

```bash
# Cyrillic to Arabic
python kazConvert.py A "сәлем"

# Arabic to Cyrillic
python kazConvert.py C "سالەم"
```

## 📚 Examples

### Greeting Conversion
```bash
python kazConvert.py A "Қалың қалай?"
# Output: قالىڭ قالاي؟
```

### Name Conversion
```bash
python kazConvert.py A "Менің атым Омега"
# Output: مەنىڭ اتىم ومەگا
```

### Full Sentence
```bash
python kazConvert.py C "سالەم الەم"
# Output: Сәлем әлем
```

## 🔧 Parameters

| Parameter | Description | Example |
|-----------|-------------|---------|
| `A` | Convert to Arabic | `python kazConvert.py A "текст"` |
| `C` | Convert to Cyrillic | `python kazConvert.py C "سالەم الەم"` |
| `text` | Text to convert | Wrap in quotes |

## 🪟 Windows PowerShell Tips

```powershell
# Method 1: Set UTF-8 encoding
$env:PYTHONIOENCODING="utf-8"; python kazConvert.py A "сәлем"

# Method 2: Change console code page
chcp 65001; python kazConvert.py A "сәлем"
```

## 🔤 Character Mapping

### Kazakh Cyrillic → Arabic
| Cyrillic | Arabic | Name |
|----------|--------|------|
| ә | ە | Shwa |
| і...