Metadata-Version: 2.4
Name: stapel-translate
Version: 0.6.0
Summary: AI-powered content translation Django app for the Stapel framework
License: MIT
Project-URL: Homepage, https://github.com/usestapel/stapel-translate
Project-URL: Repository, https://github.com/usestapel/stapel-translate
Project-URL: Documentation, https://github.com/usestapel/stapel-translate#readme
Project-URL: Changelog, https://github.com/usestapel/stapel-translate/blob/main/CHANGELOG.md
Project-URL: Issues, https://github.com/usestapel/stapel-translate/issues
Keywords: django,stapel,translation,i18n,ai
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: Django
Classifier: Framework :: Django :: 5.2
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Typing :: Typed
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: stapel-core<1.0,>=0.24.0
Provides-Extra: kafka
Requires-Dist: confluent-kafka>=2.3; extra == "kafka"
Provides-Extra: images
Requires-Dist: Pillow>=10; extra == "images"
Provides-Extra: all
Requires-Dist: stapel-translate[images,kafka]; extra == "all"
Dynamic: license-file

<!-- Generated by stapel-readme from docs/readme.md + docs/*.json. Do not edit this file; edit docs/readme.md and re-run `make readme`. -->

# stapel-translate

[![CI](https://img.shields.io/github/actions/workflow/status/usestapel/stapel-translate/ci.yml?branch=main&logo=github&label=CI)](https://github.com/usestapel/stapel-translate/actions/workflows/ci.yml?query=branch%3Amain)
[![coverage](https://img.shields.io/codecov/c/github/usestapel/stapel-translate?branch=main&logo=codecov&label=coverage)](https://app.codecov.io/gh/usestapel/stapel-translate)
[![pypi](https://img.shields.io/pypi/v/stapel-translate?logo=pypi&logoColor=white&label=pypi)](https://pypi.org/project/stapel-translate/)
[![downloads](https://static.pepy.tech/badge/stapel-translate/month)](https://pepy.tech/project/stapel-translate)
[![python](https://img.shields.io/pypi/pyversions/stapel-translate?logo=python&logoColor=white)](https://pypi.org/project/stapel-translate/)
[![license](https://img.shields.io/github/license/usestapel/stapel-translate)](https://github.com/usestapel/stapel-translate/blob/main/LICENSE)
[![llms.txt](https://img.shields.io/badge/llms.txt-blue)](https://github.com/usestapel/stapel-translate/blob/main/docs/llms.txt)

> AI-powered content translation: a TranslationEntry/TranslationValue store across a configurable language set, an LLM-routed translate.resolve comm Function with English-fallback, autofill/verification workflows, a staff dashboard (stats, per-language editing, LLM help, export/import, orphan cleanup), a Figma plugin API, and pluggable key collectors (backend error keys, notification templates, project-specific) so keys enter without any module importing another.

Part of the [Stapel framework](https://github.com/usestapel) — composable Django apps that deploy as a monolith or as microservices without changing module code.

## Install

```bash
pip install stapel-translate
```

## At a glance

| Fact | Value |
|---|---|
| Version | `0.6.0` |
| Python | `>=3.11` (3.11, 3.12, 3.13, 3.14) |
| HTTP operations | 22 |
| Config axes | 2 |
| Usage surface | 24 |
| Extension points | 4 |
| Fleet dependencies | [`stapel-agent`](https://github.com/usestapel/stapel-agent) (optional) · [`stapel-core`](https://github.com/usestapel/stapel-core) |

## Documentation

[capabilities.json](https://github.com/usestapel/stapel-translate/blob/main/docs/capabilities.json) · [llms.txt (for agents)](https://github.com/usestapel/stapel-translate/blob/main/docs/llms.txt)

## Quick start

```python
# settings.py
INSTALLED_APPS = [
    ...
    'stapel_translate',
]
```

## Bus events

### Emits
| `translations.changed` | [schema](schemas/emits/translations.changed.json) | One or more translation keys were updated for a language. |

### Consumes
| `user.deleted` | [schema](schemas/consumes/user.deleted.json) |
| `user.deletion_initiated` | [schema](schemas/consumes/user.deletion_initiated.json) |

## License

MIT — see [LICENSE](https://github.com/usestapel/stapel-translate/blob/main/LICENSE).

---

<sub>This page is assembled by `stapel-readme` from `docs/readme.md` plus the contract artifacts in `docs/`. Edit the prose in `docs/readme.md`; the badges, facts and links above and below it are generated — do not hand-edit `README.md`.</sub>
