# 📦 @breadstone-tools/localizator-ai

| Package Status | Source |
|----------------|--------|
| [![npm](https://img.shields.io/npm/v/@breadstone-tools/localizator-ai?label=npm)](https://www.npmjs.com/package/@breadstone-tools/localizator-ai) | [tools/localizator/ai](../../tools/localizator/ai) |

> AI-based translation strategies for the Localizator toolchain.
> Supports OpenAI ChatGPT and Google Gemini for automated translation generation.

---

## 📁 Project Structure

Part of the monorepo [`mosaik`](https://github.com/RueDeRennes/mosaik)
Package path: `tools/localizator/ai`
Version: see [npm](https://www.npmjs.com/package/@breadstone-tools/localizator-ai)
License: MIT

---

## 📦 Installation

```bash
yarn add @breadstone-tools/localizator-ai
# or
npm install @breadstone-tools/localizator-ai
```

---

## 🔧 Usage

```typescript
import { ResourceGenerator } from '@breadstone-tools/localizator-ai';

// Example: Generate translations using Gemini
const generator = new ResourceGenerator(logger, fileSystem, transformer, reader, {
  dryRun: false,
  chunkSize: 10,
  config: {
    apiKey: process.env.GEMINI_API_KEY,
    model: 'gemini-2.0-flash',
    temperature: 0.7,
    instructions: '' // Additional instructions for the AI
  }
});
const results = await generator.run(baseResource, ['de', 'fr'], 'gemini');
```

---

## ⚙️ Features

- AI translation via OpenAI ChatGPT and Google Gemini
- Chunked processing for large resource files
- Extensible strategy pattern

---

## 🛠 Recommendations

- Use with the Localizator CLI/app for automated translation workflows.
- Provide your API keys via environment variables or config.

---

## 📦 Publishing

```bash
yarn nx run localizator-ai:publish
```

---

## 📄 License

MIT © Breadstone

---