LLM-Translator
Overview
SimpleAITranslator is a Python library designed to identify the language of a given text and translate text between multiple languages using OpenAI's GPT-4o. The library is especially useful for translating text containing multiple languages into a single target language.
Features
- Language Detection: Identify the language of a given text in ISO 639-1 format.
- Translation: Translate text containing multiple languages into another language in ISO 639-1 format.
Requirements
To use this library, you must have an OpenAI API key. This key allows the library to utilize OpenAI's GPT-4o for translation and language detection.
Installation
You can install the SimpleAITranslator library from PyPI:
pip install simpleaitranslator
Usage
Setting the OpenAI API Key
Before using SimpleAITranslator with OpenAI, you need to set your OpenAI API key. You can do this by creating an instance of the TranslatorOpenAI class.
from simpleaitranslator.translator import TranslatorOpenAI
translator = TranslatorOpenAI(open_ai_api_key="YOUR_OPENAI_API_KEY")
Setting the Azure OpenAI API Key
If you are using Azure's OpenAI services, you need to set your Azure OpenAI API key along with additional required parameters. Use the TranslatorAzureOpenAI class for this.
from simpleaitranslator.translator import TranslatorAzureOpenAI
translator = TranslatorAzureOpenAI(
azure_endpoint="YOUR_AZURE_ENDPOINT",
api_key="YOUR_AZURE_API_KEY",
api_version="YOUR_API_VERSION",
azure_deployment="YOUR_AZURE_DEPLOYMENT"
)
Language Detection
To detect the language of a given text:
from simpleaitranslator.translator import TranslatorOpenAI
translator = TranslatorOpenAI(open_ai_api_key="YOUR_OPENAI_API_KEY")
detected_language = translator.get_text_language("Hello world")
print(detected_language.language_ISO_639_1_code)
print(detected_language.language_name)
Translation
To translate text containing multiple languages into another language:
from simpleaitranslator.translator import TranslatorOpenAI
translator = TranslatorOpenAI(open_ai_api_key="YOUR_OPENAI_API_KEY")
translated_text = translator.translate("Cześć jak się masz? Meu nome é Adam", "en")
print(translated_text)
Full Example
Here is a complete example demonstrating how to use the library:
from simpleaitranslator.translator import TranslatorOpenAI
translator = TranslatorOpenAI(open_ai_api_key="YOUR_OPENAI_API_KEY")
detected_language = translator.get_text_language("jak ty się nazywasz")
print(detected_language.language_ISO_639_1_code)
print(detected_language.language_name)
translated_text = translator.translate("Cześć jak się masz? Meu nome é Adam", "en")
print(translated_text)
Supported Languages
SimpleAITranslator supports all languages supported by GPT-4o. For a complete list of language codes, you can visit the ISO 639-1 website.
Here are some of the most popular languages and their ISO 639-1 codes:
- English:
en
- Spanish:
es
- French:
fr
- German:
de
- Chinese:
zh
- Japanese:
ja
- Korean:
ko
- Portuguese:
pt
- Russian:
ru
- Italian:
it
- Dutch:
nl
- Arabic:
ar
- Hindi:
hi
- Bengali:
bn
- Turkish:
tr
- Polish:
pl
- Swedish:
sv
- Norwegian:
no
- Danish:
da
- Finnish:
fi
- Greek:
el
- Hebrew:
he
Additional Resources
Authors
License
SimpleAITranslator is licensed under the MIT License. See the LICENSE file for more details.