<div align="center">

<img src="https://github.com/user-attachments/assets/4d865555-44d0-4238-b1d6-2ef7ddc8a3da" alt="lang-source-cli Logo" width="200"/>

# lang-source-cli

### AI-Powered Internationalization Made Simple
<sub>Transform your development process with automated, accurate translations for your applications</sub>

[![License](https://img.shields.io/badge/license-MIT-green?style=for-the-badge)](https://github.com/lang-source/lang-source-cli/blob/main/LICENCE)
[![npm version](https://img.shields.io/npm/v/lang-source-cli.svg?style=for-the-badge)](https://www.npmjs.com/package/lang-source-cli)
[![npm downloads](https://img.shields.io/npm/dm/lang-source-cli.svg?style=for-the-badge)](https://www.npmjs.com/package/lang-source-cli)

</div>

---
## ✨ Features

- 🤖 AI-powered translation engine
- 🚀 Simple command-line interface
- 🔄 Bulk translation processing
- ⚡ Fast and efficient processing
- 🔍 Intelligent context preservation

## 🚀 Installation

Install lang-source-cli globally with npm:

```bash
npm install -g lang-source-cli
# or
sudo npm install -g lang-source-cli  # incase sudo privileges are required 
```

## 🛠️ Usage

### Generate Translations

Start the translation process with a simple command:

```bash
langsource generate  # Full command
# or
langsource g        # Short version
```

> **Important**: File names should be two characters long (e.g., `en.json`)

### Interactive Workflow

<img src="https://github.com/user-attachments/assets/23430b8a-784d-46c0-89af-c51ed5e4a3cf" alt="Option Selection" width="600"/>

## 🌐 Supported Languages

| Language    | Code | Status |
|------------|------|---------|
| English    | `en` | ✅ |
| Japanese   | `ja` | ✅ |
| Korean     | `ko` | ✅ |
| Russian    | `ru` | ✅ |
| Portuguese | `pt` | ✅ |
| Arabic     | `ar` | ✅ |
| German     | `de` | ✅ |
| French     | `fr` | ✅ |
| Spanish    | `es` | ✅ |
| Italian    | `it` | ✅ |
| Chinese    | `zh` | ✅ |
| Urdu       | `ur` | ✅ |

> 💡 Need more languages? [Request a language](https://github.com/lang-source/lang-source-cli/issues)

## 💻 Development

### Prerequisites

- **Node.js** `>= 14.0.0` 
- **npm** `>= 7.0.0`

### Local Setup

1️⃣ **Clone the repository**
```bash
git clone https://github.com/lang-source/lang-source-cli.git
cd lang-source-cli
```

2️⃣ **Install dependencies**
```bash
npm install
```

3️⃣ **Build and run**
```bash
npm run build
npm run start
```

4️⃣ **Local CLI installation**
```bash
npm install -g .
```

## 🤝 Contributing

We love your input! Check out our [Contributing Guidelines](./CONTRIBUTING.md) to get started.

Ways to contribute:
- 🐛 Report bugs
- 💡 Propose new features
- 📖 Improve documentation
- 💻 Submit pull requests

## 📄 License

Copyright © 2025 lang-source-cli

Released under the [MIT License](./LICENSE).

## 💪 Support

Need help? We've got you covered!

- 📫 [Open an issue](https://github.com/lang-source/lang-source-cli/issues)
- 📧 [Email support](mailto:tahamukhtar20+langsource@gmail.com)