# Co-op Translator: Localize Your Project with a Single Command
_Easily automate multilingual translations for your projects with co-op-translator, powered by advanced LLM technology and Azure AI Services._
[](https://pypi.org/project/co-op-translator/)
[](https://github.com/azure/co-op-translator/blob/main/LICENSE)
[](https://pepy.tech/project/co-op-translator)
[](https://pepy.tech/project/co-op-translator)
[](https://GitHub.com/azure/co-op-translator/graphs/contributors/)
[](https://GitHub.com/azure/co-op-translator/issues/)
[](https://GitHub.com/azure/co-op-translator/pulls/)
[](http://makeapullrequest.com)
[](https://GitHub.com/azure/co-op-translator/watchers/)
[](https://GitHub.com/azure/co-op-translator/network/)
[](https://GitHub.com/azure/co-op-translator/stargazers/)
[](https://codespaces.new/azure/co-op-translator)
[](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/azure/co-op-translator)
## Table of contents
- [Overview](#overview)
- [Why choose Co-op Translator for Markdown translations?](#why-choose-co-op-translator-for-markdown-translations)
- [Key Features](#key-features)
- [How it works](#how-it-works)
- [Getting started with Co-op Translator](#getting-started-with-co-op-translator)
- [Prerequisites](#prerequisites)
- [Quick install](#quick-install)
- [How to use Co-op Translator](#how-to-use-co-op-translator)
- [Case Studies: Applying Co-op Translator in real projects](#case-studies-applying-co-op-translator-in-real-projects)
- [🌐Multi-language support setup](#-multi-language-support-setup)
- [Supported languages](#supported-languages)
- [Adding a new language](#adding-a-new-language)
- [Repository Structure](#repository-structure)
- [Contributing](#contributing)
- [Code of Conduct](#code-of-conduct)
- [Responsible AI](#responsible-ai)
- [Trademarks](#trademarks)
## Overview
**Co-op Translator** is a Python package designed to automate multilingual translations for your projects using advanced Large Language Model (LLM) technology and Azure AI Services. This project aims to simplify the process of translating content into multiple languages, making it accessible and efficient for developers.
By integrating Co-op Translator into your workflow, you can automatically generate organized translation folders for different languages, and translate both Markdown files and images effortlessly.
Here is an example of how Co-op Translator structures the translations and translates both Markdown files and text within images in your project:
### Why choose Co-op Translator for Markdown translations?
Have you struggled with traditional translation tools when working with Markdown files? Many translation engines fail to preserve Markdown syntax, forcing you to manually fix formatting issues after translation. Even advanced tools like ChatGPT can misinterpret code blocks, making it hard to copy and paste the translated content while maintaining the original structure.
**Co-op Translator** is specifically designed to solve these problems. With a single command, you can translate all Markdown files and images in your project into any desired language while preserving the correct Markdown syntax.
Translate your project's Markdown files effortlessly with Co-op Translator!
### Key features
- **Automated translations**: Easily translate text in your project files into multiple languages.
- **Comprehensive coverage**: Translate all Markdown files and text within images in your project directories.
- **Advanced LLM technology**: Utilize cutting-edge language models for high-quality translations.
- **Simplify localization**: Streamline the process of localizing your project for international markets.
- **Easy integration**: Seamlessly integrate with your existing project setup.
### How it works
The process begins with Markdown and image files from your project folder, which are processed by **Azure AI Services**:
- **Azure OpenAI**: Translates text from Markdown files.
- **Azure Computer Vision**: Extracts text from images, which are then translated by Azure OpenAI.
The final translated Markdown and image files are saved in the designated translation folder, ready to be used in multiple languages.
## Getting started with Co-op Translator
### Prerequisites
- Azure Computer vision resource
- Azure OpenAI resource
- Python 3.10 or higher
### Quick install
#### Install Co-op Translator via pip
```bash
pip install co-op-translator
```
#### Install Co-op Translator via poetry
```bash
poetry add co-op-translator
```
### How to use Co-op Translator
1. [Set up Azure resources before starting](./getting_started/set-up-azure-resources.md)
1. [Create an '.env' file in the root directory](./getting_started/create-env-file.md)
1. [Install the Co-op translator package](./getting_started/install-package.md)
1. [Translate your project using Co-op Translator](./getting_started/translator-your-project.md)
### Case Studies: Applying Co-op Translator in real projects
These case studies show how Co-op Translator was applied to translate a real-world project. It highlights the translation process, the challenges encountered, and the results achieved, providing a useful reference for applying the tool to similar projects.
1. [Phi-3 Cookbook translation: A case study](./getting_started/Phi-3Cookbook-translation-case.md)
## 🌐 Multi-language support setup
Before starting the translation process, you can add a table in the README that links to the translated versions of your document. Co-op Translator will automatically adjust these links during the translation process, allowing users to seamlessly switch between different language versions.
For example, if a user navigates to the Korean README, they can easily switch to other translations like Spanish or Japanese without leaving the translated page.
Here is an example of how the table should look before running the translation:
### Example
```md
## 🌐 Multi-Language Support
> **Note:**
> These translations were automatically generated using the open-source [co-op-translator](https://github.com/Azure/co-op-translator) and may contain errors or inaccuracies. For critical information, it is recommended to refer to the original or consult a professional human translation. If you'd like to add or update a translation, please refer to the [co-op-translator](https://github.com/Azure/co-op-translator) repository, where you can easily contribute using simple commands.
| Language | Code | Link to Translated README | Last Updated |
|----------------------|------|---------------------------------------------------------|--------------|
| Chinese (Simplified) | zh | [Chinese Translation](./translations/zh/README.md) | 2024-10-04 |
| Chinese (Traditional)| tw | [Chinese Translation](./translations/tw/README.md) | 2024-10-04 |
| French | fr | [French Translation](./translations/fr/README.md) | 2024-10-04 |
| Japanese | ja | [Japanese Translation](./translations/ja/README.md) | 2024-10-04 |
| Korean | ko | [Korean Translation](./translations/ko/README.md) | 2024-10-04 |
| Spanish | es | [Spanish Translation](./translations/es/README.md) | 2024-10-04 |
```
### Simplified example
```md
## 🌐 Multi-Language Support
| [English](./translations/en/README.md) | [French](./translations/fr/README.md) | [Spanish](./translations/es/README.md) | [German](./translations/de/README.md) | [Russian](./translations/ru/README.md) | [Arabic](./translations/ar/README.md) | [Persian (Farsi)](./translations/fa/README.md) | [Urdu](./translations/ur/README.md) | [Chinese (Simplified)](./translations/zh/README.md) | [Chinese (Traditional, Macau)](./translations/mo/README.md) | [Chinese (Traditional, Hong Kong)](./translations/hk/README.md) | [Chinese (Traditional, Taiwan)](./translations/tw/README.md) | [Japanese](./translations/ja/README.md) | [Korean](./translations/ko/README.md) | [Hindi](./translations/hi/README.md) | [Bengali](./translations/bn/README.md) | [Marathi](./translations/mr/README.md) | [Nepali](./translations/ne/README.md) | [Punjabi (Gurmukhi)](./translations/pa/README.md) | [Portuguese](./translations/pt/README.md) | [Italian](./translations/it/README.md) | [Polish](./translations/pl/README.md) | [Turkish](./translations/tr/README.md) | [Greek](./translations/el/README.md) | [Thai](./translations/th/README.md) | [Swedish](./translations/sv/README.md) | [Danish](./translations/da/README.md) | [Norwegian](./translations/no/README.md) | [Finnish](./translations/fi/README.md) | [Dutch](./translations/nl/README.md) | [Hebrew](./translations/he/README.md) | [Vietnamese](./translations/vi/README.md) | [Indonesian](./translations/id/README.md) | [Malay](./translations/ms/README.md) | [Tagalog (Filipino)](./translations/tl/README.md) | [Swahili](./translations/sw/README.md) | [Hungarian](./translations/hu/README.md) | [Czech](./translations/cs/README.md) | [Slovak](./translations/sk/README.md) | [Romanian](./translations/ro/README.md) | [Bulgarian](./translations/bg/README.md) | [Serbian (Cyrillic)](./translations/sr/README.md) | [Croatian](./translations/hr/README.md) | [Slovenian](./translations/sl/README.md) |
> **Note:**
> These translations were automatically generated using the open-source [co-op-translator](https://github.com/Azure/co-op-translator) and may contain errors or inaccuracies. For critical information, it is recommended to refer to the original or consult a professional human translation. If you'd like to add or update a translation, please refer to the [co-op-translator](https://github.com/Azure/co-op-translator) repository, where you can easily contribute using simple commands.
```
## Supported languages
The table below lists the languages currently supported by **Co-op Translator**. It includes language codes, language names, and any known issues associated with each language. If you would like to add support for a new language, please add the corresponding language code, name, and appropriate font in the `font_language_mappings.yml` file located at `src/co_op_translator/fonts/` and submit a pull request after testing.
| Language Code | Language Name | Font | RTL Support | Known Issues |
|---------------|----------------------|-----------------------------------|-------------|--------------|
| en | English | NotoSans-Medium.ttf | No | No |
| fr | French | NotoSans-Medium.ttf | No | No |
| es | Spanish | NotoSans-Medium.ttf | No | No |
| de | German | NotoSans-Medium.ttf | No | No |
| ru | Russian | NotoSans-Medium.ttf | No | No |
| ar | Arabic | NotoSansArabic-Medium.ttf | Yes | Yes |
| fa | Persian (Farsi) | NotoSansArabic-Medium.ttf | Yes | Yes |
| ur | Urdu | NotoSansArabic-Medium.ttf | Yes | Yes |
| zh | Chinese (Simplified) | NotoSansCJK-Medium.ttc | No | No |
| mo | Chinese (Traditional, Macau) | NotoSansCJK-Medium.ttc | No | No |
| hk | Chinese (Traditional, Hong Kong) | NotoSansCJK-Medium.ttc | No | No |
| tw | Chinese (Traditional, Taiwan) | NotoSansCJK-Medium.ttc | No | No |
| ja | Japanese | NotoSansCJK-Medium.ttc | No | No |
| ko | Korean | NotoSansCJK-Medium.ttc | No | No |
| hi | Hindi | NotoSansDevanagari-Medium.ttf | No | No |
| bn | Bengali | NotoSansBengali-Medium.ttf | No | No |
| mr | Marathi | NotoSansDevanagari-Medium.ttf | No | No |
| ne | Nepali | NotoSansDevanagari-Medium.ttf | No | No |
| pa | Punjabi (Gurmukhi) | NotoSansGurmukhi-Medium.ttf | No | No |
| pt | Portuguese | NotoSans-Medium.ttf | No | No |
| it | Italian | NotoSans-Medium.ttf | No | No |
| pl | Polish | NotoSans-Medium.ttf | No | No |
| tr | Turkish | NotoSans-Medium.ttf | No | No |
| el | Greek | NotoSans-Medium.ttf | No | No |
| th | Thai | NotoSansThai-Medium.ttf | No | No |
| sv | Swedish | NotoSans-Medium.ttf | No | No |
| da | Danish | NotoSans-Medium.ttf | No | No |
| no | Norwegian | NotoSans-Medium.ttf | No | No |
| fi | Finnish | NotoSans-Medium.ttf | No | No |
| nl | Dutch | NotoSans-Medium.ttf | No | No |
| he | Hebrew | NotoSansHebrew-Medium.ttf | Yes | No |
| vi | Vietnamese | NotoSans-Medium.ttf | No | No |
| id | Indonesian | NotoSans-Medium.ttf | No | No |
| ms | Malay | NotoSans-Medium.ttf | No | No |
| tl | Tagalog (Filipino) | NotoSans-Medium.ttf | No | No |
| sw | Swahili | NotoSans-Medium.ttf | No | No |
| hu | Hungarian | NotoSans-Medium.ttf | No | No |
| cs | Czech | NotoSans-Medium.ttf | No | No |
| sk | Slovak | NotoSans-Medium.ttf | No | No |
| ro | Romanian | NotoSans-Medium.ttf | No | No |
| bg | Bulgarian | NotoSans-Medium.ttf | No | No |
| sr | Serbian (Cyrillic) | NotoSans-Medium.ttf | No | No |
| hr | Croatian | NotoSans-Medium.ttf | No | No |
| sl | Slovenian | NotoSans-Medium.ttf | No | No |
### Adding a new language
To add support for a new language:
1. Go to [src/co_op_translator/fonts/font_language_mappings.yml](https://github.com/Azure/co-op-translator/blob/main/src/co_op_translator/fonts/font_language_mappings.yml).
2. Add the language code, name, and appropriate font file name. Make sure to include the `rtl` attribute if the language is right-to-left.
3. If you need to use a new font, ensure that the font is free to use in open-source projects by checking its licensing and copyright terms. After verifying, add the font file to the `src/co_op_translator/fonts/` directory.
4. Test your changes locally to ensure that the new language is properly supported.
5. Submit a Pull Request with your changes and indicate the addition of the new language in the PR description.
Example:
```yaml
new_lang:
name: "New Language"
font: "NotoSans-Medium.ttf"
rtl: false
```
## Repository Structure
- **src/co_op_translator/**: Source code for the translator.
- **getting_started/**: Guides and tutorials to get started.
- **imgs/**: Images used in documentation.
- **tests/**: Test cases for the project.
- **data/**: Contains data files.
## Contributing
This project welcomes contributions and suggestions. Interested in contributing to Azure Co-op Translator? Please see our [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines on how you can help make Co-op Translator more accessible.
## Contributors
[](https://github.com/Azure/co-op-translator/graphs/contributors)
## Code of Conduct
This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
## Responsible AI
Microsoft is committed to helping our customers use our AI products responsibly, sharing our learnings, and building trust-based partnerships through tools like Transparency Notes and Impact Assessments. Many of these resources can be found at [https://aka.ms/RAI](https://aka.ms/RAI).
Microsoft’s approach to responsible AI is grounded in our AI principles of fairness, reliability and safety, privacy and security, inclusiveness, transparency, and accountability.
Large-scale natural language, image, and speech models - like the ones used in this sample - can potentially behave in ways that are unfair, unreliable, or offensive, in turn causing harms. Please consult the [Azure OpenAI service Transparency note](https://learn.microsoft.com/legal/cognitive-services/openai/transparency-note?tabs=text) to be informed about risks and limitations.
The recommended approach to mitigating these risks is to include a safety system in your architecture that can detect and prevent harmful behavior. [Azure AI Content Safety](https://learn.microsoft.com/azure/ai-services/content-safety/overview) provides an independent layer of protection, able to detect harmful user-generated and AI-generated content in applications and services. Azure AI Content Safety includes text and image APIs that allow you to detect material that is harmful. We also have an interactive Content Safety Studio that allows you to view, explore and try out sample code for detecting harmful content across different modalities. The following [quickstart documentation](https://learn.microsoft.com/azure/ai-services/content-safety/quickstart-text?tabs=visual-studio%2Clinux&pivots=programming-language-rest) guides you through making requests to the service.
Another aspect to take into account is the overall application performance. With multi-modal and multi-models applications, we consider performance to mean that the system performs as you and your users expect, including not generating harmful outputs. It's important to assess the performance of your overall application using [generation quality and risk and safety metrics](https://learn.microsoft.com/azure/ai-studio/concepts/evaluation-metrics-built-in).
You can evaluate your AI application in your development environment using the [prompt flow SDK](https://microsoft.github.io/promptflow/index.html). Given either a test dataset or a target, your generative AI application generations are quantitatively measured with built-in evaluators or custom evaluators of your choice. To get started with the prompt flow sdk to evaluate your system, you can follow the [quickstart guide](https://learn.microsoft.com/azure/ai-studio/how-to/develop/flow-evaluate-sdk). Once you execute an evaluation run, you can [visualize the results in Azure AI Studio](https://learn.microsoft.com/azure/ai-studio/how-to/evaluate-flow-results).
## Trademarks
This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft
trademarks or logos is subject to and must follow
[Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).
Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.
Any use of third-party trademarks or logos are subject to those third-party's policies.
Raw data
{
"_id": null,
"home_page": "https://github.com/Azure/co-op-translator",
"name": "co-op-translator",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.10",
"maintainer_email": null,
"keywords": "translator, translation, azure, openai, gpt",
"author": "Minseok Song",
"author_email": "skytin1004@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/77/6c/8096ccf310bbc53c227aa2f13a78a9125e42980a473b2581f98934672411/co_op_translator-0.5.1.tar.gz",
"platform": null,
"description": "\n\n# Co-op Translator: Localize Your Project with a Single Command\n\n_Easily automate multilingual translations for your projects with co-op-translator, powered by advanced LLM technology and Azure AI Services._\n\n[](https://pypi.org/project/co-op-translator/)\n[](https://github.com/azure/co-op-translator/blob/main/LICENSE)\n[](https://pepy.tech/project/co-op-translator)\n[](https://pepy.tech/project/co-op-translator)\n\n[](https://GitHub.com/azure/co-op-translator/graphs/contributors/)\n[](https://GitHub.com/azure/co-op-translator/issues/)\n[](https://GitHub.com/azure/co-op-translator/pulls/)\n[](http://makeapullrequest.com)\n\n[](https://GitHub.com/azure/co-op-translator/watchers/)\n[](https://GitHub.com/azure/co-op-translator/network/)\n[](https://GitHub.com/azure/co-op-translator/stargazers/)\n\n[](https://codespaces.new/azure/co-op-translator)\n[](https://vscode.dev/redirect?url=vscode://ms-vscode-remote.remote-containers/cloneInVolume?url=https://github.com/azure/co-op-translator)\n\n## Table of contents\n\n- [Overview](#overview)\n- [Why choose Co-op Translator for Markdown translations?](#why-choose-co-op-translator-for-markdown-translations)\n- [Key Features](#key-features)\n- [How it works](#how-it-works)\n- [Getting started with Co-op Translator](#getting-started-with-co-op-translator)\n - [Prerequisites](#prerequisites)\n - [Quick install](#quick-install)\n - [How to use Co-op Translator](#how-to-use-co-op-translator)\n- [Case Studies: Applying Co-op Translator in real projects](#case-studies-applying-co-op-translator-in-real-projects)\n- [\ud83c\udf10Multi-language support setup](#-multi-language-support-setup)\n- [Supported languages](#supported-languages)\n- [Adding a new language](#adding-a-new-language)\n- [Repository Structure](#repository-structure)\n- [Contributing](#contributing)\n- [Code of Conduct](#code-of-conduct)\n- [Responsible AI](#responsible-ai)\n- [Trademarks](#trademarks)\n\n## Overview\n\n**Co-op Translator** is a Python package designed to automate multilingual translations for your projects using advanced Large Language Model (LLM) technology and Azure AI Services. This project aims to simplify the process of translating content into multiple languages, making it accessible and efficient for developers.\n\nBy integrating Co-op Translator into your workflow, you can automatically generate organized translation folders for different languages, and translate both Markdown files and images effortlessly.\n\nHere is an example of how Co-op Translator structures the translations and translates both Markdown files and text within images in your project:\n\n\n\n### Why choose Co-op Translator for Markdown translations?\n\nHave you struggled with traditional translation tools when working with Markdown files? Many translation engines fail to preserve Markdown syntax, forcing you to manually fix formatting issues after translation. Even advanced tools like ChatGPT can misinterpret code blocks, making it hard to copy and paste the translated content while maintaining the original structure.\n\n**Co-op Translator** is specifically designed to solve these problems. With a single command, you can translate all Markdown files and images in your project into any desired language while preserving the correct Markdown syntax.\n\nTranslate your project's Markdown files effortlessly with Co-op Translator!\n\n### Key features\n\n- **Automated translations**: Easily translate text in your project files into multiple languages.\n- **Comprehensive coverage**: Translate all Markdown files and text within images in your project directories.\n- **Advanced LLM technology**: Utilize cutting-edge language models for high-quality translations.\n- **Simplify localization**: Streamline the process of localizing your project for international markets.\n- **Easy integration**: Seamlessly integrate with your existing project setup.\n\n### How it works\n\n\n\nThe process begins with Markdown and image files from your project folder, which are processed by **Azure AI Services**:\n\n- **Azure OpenAI**: Translates text from Markdown files.\n- **Azure Computer Vision**: Extracts text from images, which are then translated by Azure OpenAI.\n\nThe final translated Markdown and image files are saved in the designated translation folder, ready to be used in multiple languages.\n\n## Getting started with Co-op Translator\n\n### Prerequisites\n\n- Azure Computer vision resource\n- Azure OpenAI resource\n- Python 3.10 or higher\n\n### Quick install\n\n#### Install Co-op Translator via pip\n\n```bash\npip install co-op-translator\n```\n\n#### Install Co-op Translator via poetry\n\n```bash\npoetry add co-op-translator\n```\n\n### How to use Co-op Translator\n\n1. [Set up Azure resources before starting](./getting_started/set-up-azure-resources.md)\n1. [Create an '.env' file in the root directory](./getting_started/create-env-file.md)\n1. [Install the Co-op translator package](./getting_started/install-package.md)\n1. [Translate your project using Co-op Translator](./getting_started/translator-your-project.md)\n\n### Case Studies: Applying Co-op Translator in real projects\n\nThese case studies show how Co-op Translator was applied to translate a real-world project. It highlights the translation process, the challenges encountered, and the results achieved, providing a useful reference for applying the tool to similar projects.\n\n1. [Phi-3 Cookbook translation: A case study](./getting_started/Phi-3Cookbook-translation-case.md)\n\n## \ud83c\udf10 Multi-language support setup\n\nBefore starting the translation process, you can add a table in the README that links to the translated versions of your document. Co-op Translator will automatically adjust these links during the translation process, allowing users to seamlessly switch between different language versions.\n\nFor example, if a user navigates to the Korean README, they can easily switch to other translations like Spanish or Japanese without leaving the translated page.\n\nHere is an example of how the table should look before running the translation:\n\n### Example\n\n```md\n## \ud83c\udf10 Multi-Language Support\n\n> **Note:**\n> These translations were automatically generated using the open-source [co-op-translator](https://github.com/Azure/co-op-translator) and may contain errors or inaccuracies. For critical information, it is recommended to refer to the original or consult a professional human translation. If you'd like to add or update a translation, please refer to the [co-op-translator](https://github.com/Azure/co-op-translator) repository, where you can easily contribute using simple commands.\n\n| Language | Code | Link to Translated README | Last Updated |\n|----------------------|------|---------------------------------------------------------|--------------|\n| Chinese (Simplified) | zh | [Chinese Translation](./translations/zh/README.md) | 2024-10-04 |\n| Chinese (Traditional)| tw | [Chinese Translation](./translations/tw/README.md) | 2024-10-04 |\n| French | fr | [French Translation](./translations/fr/README.md) | 2024-10-04 |\n| Japanese | ja | [Japanese Translation](./translations/ja/README.md) | 2024-10-04 |\n| Korean | ko | [Korean Translation](./translations/ko/README.md) | 2024-10-04 |\n| Spanish | es | [Spanish Translation](./translations/es/README.md) | 2024-10-04 |\n```\n\n### Simplified example\n\n```md\n## \ud83c\udf10 Multi-Language Support\n\n| [English](./translations/en/README.md) | [French](./translations/fr/README.md) | [Spanish](./translations/es/README.md) | [German](./translations/de/README.md) | [Russian](./translations/ru/README.md) | [Arabic](./translations/ar/README.md) | [Persian (Farsi)](./translations/fa/README.md) | [Urdu](./translations/ur/README.md) | [Chinese (Simplified)](./translations/zh/README.md) | [Chinese (Traditional, Macau)](./translations/mo/README.md) | [Chinese (Traditional, Hong Kong)](./translations/hk/README.md) | [Chinese (Traditional, Taiwan)](./translations/tw/README.md) | [Japanese](./translations/ja/README.md) | [Korean](./translations/ko/README.md) | [Hindi](./translations/hi/README.md) | [Bengali](./translations/bn/README.md) | [Marathi](./translations/mr/README.md) | [Nepali](./translations/ne/README.md) | [Punjabi (Gurmukhi)](./translations/pa/README.md) | [Portuguese](./translations/pt/README.md) | [Italian](./translations/it/README.md) | [Polish](./translations/pl/README.md) | [Turkish](./translations/tr/README.md) | [Greek](./translations/el/README.md) | [Thai](./translations/th/README.md) | [Swedish](./translations/sv/README.md) | [Danish](./translations/da/README.md) | [Norwegian](./translations/no/README.md) | [Finnish](./translations/fi/README.md) | [Dutch](./translations/nl/README.md) | [Hebrew](./translations/he/README.md) | [Vietnamese](./translations/vi/README.md) | [Indonesian](./translations/id/README.md) | [Malay](./translations/ms/README.md) | [Tagalog (Filipino)](./translations/tl/README.md) | [Swahili](./translations/sw/README.md) | [Hungarian](./translations/hu/README.md) | [Czech](./translations/cs/README.md) | [Slovak](./translations/sk/README.md) | [Romanian](./translations/ro/README.md) | [Bulgarian](./translations/bg/README.md) | [Serbian (Cyrillic)](./translations/sr/README.md) | [Croatian](./translations/hr/README.md) | [Slovenian](./translations/sl/README.md) |\n\n> **Note:**\n> These translations were automatically generated using the open-source [co-op-translator](https://github.com/Azure/co-op-translator) and may contain errors or inaccuracies. For critical information, it is recommended to refer to the original or consult a professional human translation. If you'd like to add or update a translation, please refer to the [co-op-translator](https://github.com/Azure/co-op-translator) repository, where you can easily contribute using simple commands.\n```\n\n## Supported languages\n\nThe table below lists the languages currently supported by **Co-op Translator**. It includes language codes, language names, and any known issues associated with each language. If you would like to add support for a new language, please add the corresponding language code, name, and appropriate font in the `font_language_mappings.yml` file located at `src/co_op_translator/fonts/` and submit a pull request after testing.\n\n| Language Code | Language Name | Font | RTL Support | Known Issues |\n|---------------|----------------------|-----------------------------------|-------------|--------------|\n| en | English | NotoSans-Medium.ttf | No | No |\n| fr | French | NotoSans-Medium.ttf | No | No |\n| es | Spanish | NotoSans-Medium.ttf | No | No |\n| de | German | NotoSans-Medium.ttf | No | No |\n| ru | Russian | NotoSans-Medium.ttf | No | No |\n| ar | Arabic | NotoSansArabic-Medium.ttf | Yes | Yes |\n| fa | Persian (Farsi) | NotoSansArabic-Medium.ttf | Yes | Yes |\n| ur | Urdu | NotoSansArabic-Medium.ttf | Yes | Yes |\n| zh | Chinese (Simplified) | NotoSansCJK-Medium.ttc | No | No |\n| mo | Chinese (Traditional, Macau) | NotoSansCJK-Medium.ttc | No | No |\n| hk | Chinese (Traditional, Hong Kong) | NotoSansCJK-Medium.ttc | No | No |\n| tw | Chinese (Traditional, Taiwan) | NotoSansCJK-Medium.ttc | No | No |\n| ja | Japanese | NotoSansCJK-Medium.ttc | No | No |\n| ko | Korean | NotoSansCJK-Medium.ttc | No | No |\n| hi | Hindi | NotoSansDevanagari-Medium.ttf | No | No |\n| bn | Bengali | NotoSansBengali-Medium.ttf | No | No |\n| mr | Marathi | NotoSansDevanagari-Medium.ttf | No | No |\n| ne | Nepali | NotoSansDevanagari-Medium.ttf | No | No |\n| pa | Punjabi (Gurmukhi) | NotoSansGurmukhi-Medium.ttf | No | No |\n| pt | Portuguese | NotoSans-Medium.ttf | No | No |\n| it | Italian | NotoSans-Medium.ttf | No | No |\n| pl | Polish | NotoSans-Medium.ttf | No | No |\n| tr | Turkish | NotoSans-Medium.ttf | No | No |\n| el | Greek | NotoSans-Medium.ttf | No | No |\n| th | Thai | NotoSansThai-Medium.ttf | No | No |\n| sv | Swedish | NotoSans-Medium.ttf | No | No |\n| da | Danish | NotoSans-Medium.ttf | No | No |\n| no | Norwegian | NotoSans-Medium.ttf | No | No |\n| fi | Finnish | NotoSans-Medium.ttf | No | No |\n| nl | Dutch | NotoSans-Medium.ttf | No | No |\n| he | Hebrew | NotoSansHebrew-Medium.ttf | Yes | No |\n| vi | Vietnamese | NotoSans-Medium.ttf | No | No |\n| id | Indonesian | NotoSans-Medium.ttf | No | No |\n| ms | Malay | NotoSans-Medium.ttf | No | No |\n| tl | Tagalog (Filipino) | NotoSans-Medium.ttf | No | No |\n| sw | Swahili | NotoSans-Medium.ttf | No | No |\n| hu | Hungarian | NotoSans-Medium.ttf | No | No |\n| cs | Czech | NotoSans-Medium.ttf | No | No |\n| sk | Slovak | NotoSans-Medium.ttf | No | No |\n| ro | Romanian | NotoSans-Medium.ttf | No | No |\n| bg | Bulgarian | NotoSans-Medium.ttf | No | No |\n| sr | Serbian (Cyrillic) | NotoSans-Medium.ttf | No | No |\n| hr | Croatian | NotoSans-Medium.ttf | No | No |\n| sl | Slovenian | NotoSans-Medium.ttf | No | No |\n\n### Adding a new language\n\nTo add support for a new language:\n\n1. Go to [src/co_op_translator/fonts/font_language_mappings.yml](https://github.com/Azure/co-op-translator/blob/main/src/co_op_translator/fonts/font_language_mappings.yml).\n2. Add the language code, name, and appropriate font file name. Make sure to include the `rtl` attribute if the language is right-to-left.\n3. If you need to use a new font, ensure that the font is free to use in open-source projects by checking its licensing and copyright terms. After verifying, add the font file to the `src/co_op_translator/fonts/` directory.\n4. Test your changes locally to ensure that the new language is properly supported.\n5. Submit a Pull Request with your changes and indicate the addition of the new language in the PR description.\n\nExample:\n\n```yaml\nnew_lang:\n name: \"New Language\"\n font: \"NotoSans-Medium.ttf\"\n rtl: false\n```\n\n## Repository Structure\n\n- **src/co_op_translator/**: Source code for the translator.\n- **getting_started/**: Guides and tutorials to get started.\n- **imgs/**: Images used in documentation.\n- **tests/**: Test cases for the project.\n- **data/**: Contains data files.\n\n## Contributing\n\nThis project welcomes contributions and suggestions. Interested in contributing to Azure Co-op Translator? Please see our [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines on how you can help make Co-op Translator more accessible.\n\n## Contributors\n\n[](https://github.com/Azure/co-op-translator/graphs/contributors)\n\n## Code of Conduct\n\nThis project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).\nFor more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or\ncontact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.\n\n## Responsible AI\n\nMicrosoft is committed to helping our customers use our AI products responsibly, sharing our learnings, and building trust-based partnerships through tools like Transparency Notes and Impact Assessments. Many of these resources can be found at [https://aka.ms/RAI](https://aka.ms/RAI).\nMicrosoft\u2019s approach to responsible AI is grounded in our\u202fAI principles of fairness, reliability and safety, privacy and security, inclusiveness, transparency, and accountability.\n\nLarge-scale natural language, image, and speech models - like the ones used in this sample - can potentially behave in ways that are unfair, unreliable, or offensive, in turn causing harms. Please consult the [Azure OpenAI service Transparency note](https://learn.microsoft.com/legal/cognitive-services/openai/transparency-note?tabs=text) to be informed about risks and limitations.\n\nThe recommended approach to mitigating these risks is to include a safety system in your architecture that can detect and prevent harmful behavior. [Azure AI Content Safety](https://learn.microsoft.com/azure/ai-services/content-safety/overview) provides an independent layer of protection, able to detect harmful user-generated and AI-generated content in applications and services. Azure AI Content Safety includes text and image APIs that allow you to detect material that is harmful. We also have an interactive Content Safety Studio that allows you to view, explore and try out sample code for detecting harmful content across different modalities. The following [quickstart documentation](https://learn.microsoft.com/azure/ai-services/content-safety/quickstart-text?tabs=visual-studio%2Clinux&pivots=programming-language-rest) guides you through making requests to the service.\n\nAnother aspect to take into account is the overall application performance. With multi-modal and multi-models applications, we consider performance to mean that the system performs as you and your users expect, including not generating harmful outputs. It's important to assess the performance of your overall application using [generation quality and risk and safety metrics](https://learn.microsoft.com/azure/ai-studio/concepts/evaluation-metrics-built-in).\n\nYou can evaluate your AI application in your development environment using the [prompt flow SDK](https://microsoft.github.io/promptflow/index.html). Given either a test dataset or a target, your generative AI application generations are quantitatively measured with built-in evaluators or custom evaluators of your choice. To get started with the prompt flow sdk to evaluate your system, you can follow the [quickstart guide](https://learn.microsoft.com/azure/ai-studio/how-to/develop/flow-evaluate-sdk). Once you execute an evaluation run, you can [visualize the results in Azure AI Studio](https://learn.microsoft.com/azure/ai-studio/how-to/evaluate-flow-results).\n\n## Trademarks\n\nThis project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft\ntrademarks or logos is subject to and must follow\n[Microsoft's Trademark & Brand Guidelines](https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general).\nUse of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship.\nAny use of third-party trademarks or logos are subject to those third-party's policies.\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Easily automate multilingual translations for your projects with co-op-translator, powered by advanced LLM technology.",
"version": "0.5.1",
"project_urls": {
"Documentation": "https://github.com/Azure/co-op-translator/tree/main/getting_started",
"Homepage": "https://github.com/Azure/co-op-translator",
"Repository": "https://github.com/Azure/co-op-translator"
},
"split_keywords": [
"translator",
" translation",
" azure",
" openai",
" gpt"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a3719c3cb3765b8763ff6f20163dfc29e083fee3c86bdf28217e17a81dedcda1",
"md5": "c769e15f83eac8427be181570d588612",
"sha256": "6a68f0dc3ccf814b83b5ee9ae8bb2309c1d14d2245816b0543c0ebfa668cdeec"
},
"downloads": -1,
"filename": "co_op_translator-0.5.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c769e15f83eac8427be181570d588612",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.10",
"size": 15648564,
"upload_time": "2024-11-10T03:41:59",
"upload_time_iso_8601": "2024-11-10T03:41:59.480644Z",
"url": "https://files.pythonhosted.org/packages/a3/71/9c3cb3765b8763ff6f20163dfc29e083fee3c86bdf28217e17a81dedcda1/co_op_translator-0.5.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "776c8096ccf310bbc53c227aa2f13a78a9125e42980a473b2581f98934672411",
"md5": "4fc8f63462c0366f8738aa90b8b97112",
"sha256": "e4996dff20d8e99239dd854e776fd97f588d04ec6648c0a993c650ed5567bfeb"
},
"downloads": -1,
"filename": "co_op_translator-0.5.1.tar.gz",
"has_sig": false,
"md5_digest": "4fc8f63462c0366f8738aa90b8b97112",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.10",
"size": 15641420,
"upload_time": "2024-11-10T03:42:03",
"upload_time_iso_8601": "2024-11-10T03:42:03.045358Z",
"url": "https://files.pythonhosted.org/packages/77/6c/8096ccf310bbc53c227aa2f13a78a9125e42980a473b2581f98934672411/co_op_translator-0.5.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-10 03:42:03",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Azure",
"github_project": "co-op-translator",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "annotated-types",
"specs": [
[
"~=",
"0.7.0"
]
]
},
{
"name": "anyio",
"specs": [
[
"~=",
"4.4.0"
]
]
},
{
"name": "appnope",
"specs": [
[
"~=",
"0.1.4"
]
]
},
{
"name": "asttokens",
"specs": [
[
"~=",
"2.4.1"
]
]
},
{
"name": "azure-ai-vision-imageanalysis",
"specs": [
[
"~=",
"1.0.0b2"
]
]
},
{
"name": "azure-cognitiveservices-vision-computervision",
"specs": [
[
"~=",
"0.9.0"
]
]
},
{
"name": "azure-common",
"specs": [
[
"~=",
"1.1.28"
]
]
},
{
"name": "azure-core",
"specs": [
[
"~=",
"1.30.2"
]
]
},
{
"name": "certifi",
"specs": [
[
"~=",
"2024.6.2"
]
]
},
{
"name": "charset-normalizer",
"specs": [
[
"~=",
"3.3.2"
]
]
},
{
"name": "click",
"specs": [
[
"~=",
"8.1.7"
]
]
},
{
"name": "comm",
"specs": [
[
"~=",
"0.2.2"
]
]
},
{
"name": "contourpy",
"specs": [
[
"~=",
"1.2.1"
]
]
},
{
"name": "cycler",
"specs": [
[
"~=",
"0.12.1"
]
]
},
{
"name": "decorator",
"specs": [
[
"~=",
"5.1.1"
]
]
},
{
"name": "distro",
"specs": [
[
"~=",
"1.9.0"
]
]
},
{
"name": "executing",
"specs": [
[
"~=",
"2.0.1"
]
]
},
{
"name": "fonttools",
"specs": [
[
"~=",
"4.53.0"
]
]
},
{
"name": "h11",
"specs": [
[
"~=",
"0.14.0"
]
]
},
{
"name": "httpcore",
"specs": [
[
"~=",
"1.0.5"
]
]
},
{
"name": "httpx",
"specs": [
[
"~=",
"0.27.0"
]
]
},
{
"name": "idna",
"specs": [
[
"~=",
"3.7"
]
]
},
{
"name": "isodate",
"specs": [
[
"~=",
"0.6.1"
]
]
},
{
"name": "jedi",
"specs": [
[
"~=",
"0.19.1"
]
]
},
{
"name": "kiwisolver",
"specs": [
[
"~=",
"1.4.5"
]
]
},
{
"name": "matplotlib",
"specs": [
[
"~=",
"3.9.0"
]
]
},
{
"name": "matplotlib-inline",
"specs": [
[
"~=",
"0.1.7"
]
]
},
{
"name": "msrest",
"specs": [
[
"~=",
"0.7.1"
]
]
},
{
"name": "numpy",
"specs": [
[
"~=",
"1.25.2"
]
]
},
{
"name": "oauthlib",
"specs": [
[
"~=",
"3.2.2"
]
]
},
{
"name": "openai",
"specs": [
[
"~=",
"1.33.0"
]
]
},
{
"name": "opencv-python",
"specs": [
[
"~=",
"4.10.0.82"
]
]
},
{
"name": "packaging",
"specs": [
[
"~=",
"24.1"
]
]
},
{
"name": "parso",
"specs": [
[
"~=",
"0.8.4"
]
]
},
{
"name": "pexpect",
"specs": [
[
"~=",
"4.9.0"
]
]
},
{
"name": "pillow",
"specs": [
[
"~=",
"10.3.0"
]
]
},
{
"name": "platformdirs",
"specs": [
[
"~=",
"4.2.2"
]
]
},
{
"name": "prompt_toolkit",
"specs": [
[
"~=",
"3.0.47"
]
]
},
{
"name": "psutil",
"specs": [
[
"~=",
"5.9.8"
]
]
},
{
"name": "ptyprocess",
"specs": [
[
"~=",
"0.7.0"
]
]
},
{
"name": "pure-eval",
"specs": [
[
"~=",
"0.2.2"
]
]
},
{
"name": "pydantic",
"specs": [
[
"~=",
"2.7.3"
]
]
},
{
"name": "pydantic_core",
"specs": [
[
"~=",
"2.18.4"
]
]
},
{
"name": "pyparsing",
"specs": [
[
"~=",
"3.1.2"
]
]
},
{
"name": "python-dateutil",
"specs": [
[
"~=",
"2.9.0.post0"
]
]
},
{
"name": "python-dotenv",
"specs": [
[
"~=",
"1.0.1"
]
]
},
{
"name": "pyyaml",
"specs": [
[
"~=",
"6.0.2"
]
]
},
{
"name": "pyzmq",
"specs": [
[
"~=",
"26.0.3"
]
]
},
{
"name": "requests",
"specs": [
[
"~=",
"2.32.3"
]
]
},
{
"name": "requests-oauthlib",
"specs": [
[
"~=",
"2.0.0"
]
]
},
{
"name": "semantic_kernel",
"specs": [
[
"~=",
"1.8.3"
]
]
},
{
"name": "six",
"specs": [
[
"~=",
"1.16.0"
]
]
},
{
"name": "sniffio",
"specs": [
[
"~=",
"1.3.1"
]
]
},
{
"name": "stack-data",
"specs": [
[
"~=",
"0.6.3"
]
]
},
{
"name": "tiktoken",
"specs": [
[
"~=",
"0.7.0"
]
]
},
{
"name": "tornado",
"specs": [
[
"~=",
"6.4.1"
]
]
},
{
"name": "tqdm",
"specs": [
[
"~=",
"4.66.4"
]
]
},
{
"name": "traitlets",
"specs": [
[
"~=",
"5.14.3"
]
]
},
{
"name": "typing_extensions",
"specs": [
[
"~=",
"4.12.2"
]
]
},
{
"name": "urllib3",
"specs": [
[
"~=",
"2.2.1"
]
]
},
{
"name": "wcwidth",
"specs": [
[
"~=",
"0.2.13"
]
]
},
{
"name": "pytest",
"specs": [
[
"~=",
"8.3.2"
]
]
},
{
"name": "ipykernel",
"specs": [
[
"~=",
"6.29.4"
]
]
},
{
"name": "ipython",
"specs": [
[
"~=",
"8.25.0"
]
]
},
{
"name": "jupyter_client",
"specs": [
[
"~=",
"8.6.2"
]
]
},
{
"name": "jupyter_core",
"specs": [
[
"~=",
"5.7.2"
]
]
},
{
"name": "nest-asyncio",
"specs": [
[
"~=",
"1.6.0"
]
]
},
{
"name": "debugpy",
"specs": [
[
"~=",
"1.8.1"
]
]
},
{
"name": "stack-data",
"specs": [
[
"~=",
"0.6.3"
]
]
},
{
"name": "Pygments",
"specs": [
[
"~=",
"2.18.0"
]
]
}
],
"lcname": "co-op-translator"
}
