A Python library for language detection and translation using OpenAI's GPT-4.
Project description
SimpleAITranslator
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-4. 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-3 format.
- Translation: Translate text containing multiple languages into another language in ISO 639-3 format.
Requirements
To use this library, you must have an OpenAI API key. This key allows the library to utilize OpenAI's GPT-4 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, you need to set your OpenAI API key. You can do this by calling the set_openai_api_key
function.
from simpleaitranslator.translator import set_openai_api_key
# Set your OpenAI API key
set_openai_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 set_azure_openai_api_key
function to do this.
from simpleaitranslator.translator import set_azure_openai_api_key
# Set your Azure OpenAI API key
set_azure_openai_api_key(
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 get_text_language,set_openai_api_key
set_openai_api_key("<YOUR_OPENAI_API_KEY>")
print(get_text_language("Hello world")) # Output: 'eng'
Translation
To translate text containing multiple languages into another language:
from simpleaitranslator.translator import translate, set_openai_api_key
set_openai_api_key("<YOUR_OPENAI_API_KEY>")
print(translate("Cześć jak się masz? Meu nome é Adam", "eng")) # Output: "Hello how are you? My name is Adam"
Full Example
Here is a complete example demonstrating how to use the library:
from simpleaitranslator.translator import get_text_language, translate, set_openai_api_key
set_openai_api_key("<YOUR_OPENAI_API_KEY>")
# Detect language
print(get_text_language("jak ty się nazywasz")) # Output: 'pol'
# Translate text
print(translate("Cześć jak się masz? Meu nome é Adam", "eng")) # Output: "Hello how are you? My name is Adam"
Supported Languages
SimpleAITranslator supports all languages supported by GPT-4. For a complete list of language codes, you can visit the ISO 639-3 website.
Here are some of the most popular languages and their ISO 639-3 codes:
- English (eng)
- Spanish (spa)
- French (fra)
- German (deu)
- Chinese (zho)
- Japanese (jpn)
- Korean (kor)
- Portuguese (por)
- Russian (rus)
- Italian (ita)
- Dutch (nld)
- Arabic (ara)
- Hindi (hin)
- Bengali (ben)
- Turkish (tur)
- Polish (pol)
- Swedish (swe)
- Norwegian (nor)
- Danish (dan)
- Finnish (fin)
- Greek (ell)
- Hebrew (heb)
Additional Resources
Authors
License
SimpleAITranslator is licensed under the MIT License. See the LICENSE file for more details.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for simpleaitranslator-2.0.16.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 60907f45ff43907e12e3d45a3d33114d3e12b123e84c4501990f66701ef9ae93 |
|
MD5 | 6bb8cada499d34f16f1026f289c923c9 |
|
BLAKE2b-256 | 059c5963bbc065d2f440b2bd5fed60f34de191785d2b159d40218884d0d22ec8 |
Hashes for simpleaitranslator-2.0.16-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6f1c8d4462f5bb5a551d184b85b92f841beeb9f86be76a9108ab2d7b09afe10b |
|
MD5 | d553eec920f61cdfb2588e72511085a3 |
|
BLAKE2b-256 | c50484fcdc5621b4822dd68c78f31e41f13b221fb330275fed3e438f24e2dd42 |