ai-text-translator

Intro

This project makes text translation easier, faster, and more accessible! It uses Azure AI Translate to translate text or documents. You can translate between any of the 100+ languages supported by AI Language (full list here). In other words, you can upload a document in any (supported) language and get that document translated to any (supported) language of your choosing!

More details:

The program prompts the user (you!) for desired target languages. It outputs a list of supported languages that match your target language(s) along with their corresponding language codes. Use the language codes for the next input, which will translate the text file of your choosing! The program prints and saves the translated files with updated file names! Yay!

Read time: 5 min

Build time: <5 min

Set up Azure AI Translator

Let's sign up for Azure AI Translator and get our API keys!

1. Sign up for a free Azure account here. Your free trial lasts 30 days and includes $200 Azure credits.

2. Once you're logged in to your Azure dashboard, select 'Create a Resource'.

3. Select (or search for) Translator. (Or click this link to create directly.)

4. When deployment is done, navigate to the resource you created.

5. In the 'Overview' page, click on your resource.

6. From here, grab the key, endpoint, and region for your Language resource. Under Resource Management, select 'Keys and Endpoint'.

   • Copy one of the keys (either one is fine), the Location/Region, and the Endpoint URL. Save these for later!

Onward to the code!

Need more help? Check out the full quickstart here.

Code Setup

1. Clone the GitHub repo: https://github.com/jenfoxbot/ai-text-translator

2. In the project folder, navigate to the /src folder.

3. Create a .env file to store your Cognitive Services secrets. Paste the following code: TRANSLATOR_TEXT_SUBSCRIPTION_KEY=YOURKEYHERE TRANSLATOR_TEXT_ENDPOINT=YOURENDPOINTHERE

   Replace "YOURKEYHERE" with your Language Service key. Replace "YOURENDPOINTHERE" with your Language Service endpoint.

4. In main.py, update the location (or region) in Line 19 to match your selected region.

5. In main.py, update the text_file_path variable in Line 22 to point to the file that you want to translate. The Translator service supports a whole bunch of file types (although full disclosure I have not tested them all). Note: I included a test text file (pomplemousse.txt) which you can use to test the program :)

Install Libraries and Run the Code!

Install the libraries/dependencies you'll need with the following command:

pip install -r requirements.txt

When that's finished, run the program with the following command:

python main.py

This will take you through a prompt process where you specify your target languages, grab the language codes (e.g. for English you'd use 'en' or for Spanish you'd use 'es'), and then input those into the target languages for translation.

If the program runs successfully, you'll see the translated texts print to your screen (you can disable this by commenting out line 132). You'll also have new files with the same name + the translation languages (e.g. "pomplemousse.txt_translated_to_af.txt" -- okay yes it's a lil' messy but it does the job :P).

That's it! Go forth and translate all the things!! And of course, modify the program however you see fit.

Going Further

1. Specify a target directory to save multiple files.
2. Add a 'choose file' option (would need an environment that supports a GUI).
3. Update the program to translate a single file to multiple languages or a bunch of files to the same language! Have fun :)