Simple Translate App - AWS

Installing App on VM Manually (T1)

• Create a VM Instance from AWS

  (Prerequisite: Create a KeyPair after logging in - https://us-east-1.console.aws.amazon.com/ec2/home?region=us-east-1#KeyPairs:)

  (Suggested Instance: Ubuntu (t2.large) - Ubuntu Server 24.04 LTS (HVM),EBS General Purpose (SSD) Volume Type)

• SSH into your newly created instance

• Update OS packages: sudo apt-get update

• Install Git: sudo apt install git

• Clone App Repo: git clone https://github.com/dlops-io/simple-translate-aws.git

• cd simple-translate-aws

• Install Python: sudo apt install python3-pip

• Install packages: pip3 install --break-system-packages googletrans==4.0.0rc1 art Test out the translations:

• python3 cli.py

• python3 cli.py -t "Good morning. It is a good morning for cheese." -s "en" -d "es"

• python3 cli.py -t "Good afternoon. Would you like some cheese?" -s "en" -d "fr"

Refer to language codes at the bottom of this page.

---

---

Installing App on VM using Pipenv (T2)

• Create a VM Instance from AWS (Suggested Instance: Ubuntu (t2.large) - Ubuntu Server 24.04 LTS (HVM),EBS General Purpose (SSD) Volume Type, )

• SSH into your newly created instance

• Update OS packages: sudo apt-get update

• Install Git: sudo apt install git

• Clone App Repo: git clone https://github.com/dlops-io/simple-translate-aws.git

• cd simple-translate-aws

• Install Pipenv: sudo apt install pipenv

• Install Pipenv environment from Pipfile: pipenv install

• Go into the newly created environment shell: pipenv shell Test out the translations:

• python cli.py

• python cli.py -t "Good morning. It is a good morning for cheese." -s "en" -d "es"

• python cli.py -t "Good afternoon. Would you like some cheese?" -s "en" -d "fr"

Refer to language codes at the bottom of this page.

---

---

Developing App using Containers (T3)

Prerequisites for Development using Containers

• Have Docker Desktop installed
• Cloned this repository to your local machine with a terminal up and running
• Check that your Docker is running with the following command

docker run hello-world

Install VSCode

Follow the instructions for your operating system.
If you already have a preferred text editor, skip this step.

Make sure we do not have any running containers and clear up an unused images

• Run docker container ls
• Stop any container that is running
• Run docker system prune
• Run docker image ls

Clone the github repository

• Clone or download from here

Building Docker Image

Go into the app folder by running

• cd simple-translate-aws Build the docker container by running
• docker build -t simple-translate -f Dockerfile .

Running Docker Container

Run the container using:

• docker run --rm -ti simple-translate Running the translate code
• python cli.py -t "Good morning" -s "en" -d "es" To exit from container
• Type exit from the Docker shell

Pushing Docker Image to Docker Hub

• Sign up in Docker Hub and create an Access Token
• Login to the Hub: docker login -u <USER NAME> -p <ACCESS TOKEN>
• Tag the Docker Image: docker tag simple-translate <USER NAME>/simple-translate
• Push to Docker Hub: docker push <USER NAME>/simple-translate

---

---

Running App on VM using Docker (T4)

• Create a VM Instance from AWS (Suggested Instance: Ubuntu (t2.large) - Ubuntu Server 24.04 LTS (HVM),EBS General Purpose (SSD) Volume Type, )

• SSH into your newly created instance Install Docker on the newly created instance by running

• sudo apt-get update

• sudo apt install docker.io

Check version of installed Docker

• sudo docker --version
  Run the app using Docker
• sudo docker run --rm -ti dlops/simple-translate

Run the cli

• python cli.py

Google Translate Two-Letter Language Codes

No.	Language Name	Native Language Name	Code
1	Afrikaans	Afrikaans	af
2	Albanian	Shqip	sq
3	Arabic	عربي	ar
4	Armenian	Հայերէն	hy
5	Azerbaijani	آذربایجان دیلی	az
6	Basque	Euskara	eu
7	Belarusian	Беларуская	be
8	Bulgarian	Български	bg
9	Catalan	Català	ca
10	Chinese (Simplified)	中文简体	zh-CN
11	Chinese (Traditional)	中文繁體	zh-TW
12	Croatian	Hrvatski	hr
13	Czech	Čeština	cs
14	Danish	Dansk	da
15	Dutch	Nederlands	nl
16	English	English	en
17	Estonian	Eesti keel	et
18	Filipino	Filipino	tl
19	Finnish	Suomi	fi
20	French	Français	fr
21	Galician	Galego	gl
22	Georgian	ქართული	ka
23	German	Deutsch	de
24	Greek	Ελληνικά	el
25	Haitian Creole	Kreyòl ayisyen	ht
26	Hebrew	עברית	iw
27	Hindi	हिन्दी	hi
28	Hungarian	Magyar	hu
29	Icelandic	Íslenska	is
30	Indonesian	Bahasa Indonesia	id
31	Irish	Gaeilge	ga
32	Italian	Italiano	it
33	Japanese	日本語	ja
34	Korean	한국어	ko
35	Latvian	Latviešu	lv
36	Lithuanian	Lietuvių kalba	lt
37	Macedonian	Македонски	mk
38	Malay	Malay	ms
39	Maltese	Malti	mt
40	Norwegian	Norsk	no
41	Persian	فارسی	fa
42	Polish	Polski	pl
43	Portuguese	Português	pt
44	Romanian	Română	ro
45	Russian	Русский	ru
46	Serbian	Српски	sr
47	Slovak	Slovenčina	sk
48	Slovenian	Slovensko	sl
49	Spanish	Español	es
50	Swahili	Kiswahili	sw
51	Swedish	Svenska	sv
52	Thai	ไทย	th
53	Turkish	Türkçe	tr
54	Ukrainian	Українська	uk
55	Urdu	اردو	ur
56	Vietnamese	Tiếng Việt	vi
57	Welsh	Cymraeg	cy
58	Yiddish	ייִדיש	yi