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
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.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4d78b32b1f6f28dc5c6b48fafb8f87063f1300a1e4ba338c5eb2624d5bb7f48d |
|
MD5 | ac5e0618197a6058cf0fdfe59796f8f7 |
|
BLAKE2b-256 | 8b460959600c02eb60811936ba211b880f4826a1d55a380afd8ae963a3838ea3 |