README.md

Chinese-English Translation Web App

Full-stack web application to automatically translate Chinese to English (and vice-versa) with React/Next.js/FastAPI and deep learning models (BERT) and automated cloud API load-testing with AWS EC2, Google Compute Engine, Terraform, and Locust.

Hosted at: https://easiermtl.com/

easiermtl_demo.mp4

Table of Contents

• Next.js UI
• Python
  • Backend REST API
  • Model Development & Evaluation
  • Automated Deployments & Load-Testing CLI
• Terraform Cloud Instances Deployment Configurations and Scripts
  • AWS Deployment
  • GCE Deployment
• Kubernetes + Helm Deployment to Google Kubernetes Engine (GKE)
  • Kubernetes Configuration Files
  • Guide
• Misc. Documentation
  • Research Report
  • Initial Project Proposal

Getting Started

Make sure you have the following already installed:

• Frontend
  • ^yarn 1.22.17
• Backend
  • ^poetry 1.1.11
• Deployment
  • docker
  • terraform
  • aws
  • gcloud
  • kubectl

Rest will be installed as long as you follow the documentation.

The full deployment instructions to Google Kubernetes Engine with K8s and Helm are located here.

If you don't want to use Kubernetes or want to run locally, run the ui and server separately. See the individual READMEs in ui and server for more information.

Tech Stack

• Frontend
  • React, Next.js, draft.js
• Backend
  • Python, FastAPI
• Model Development
  • PyTorch, HuggingFace
• Instance Deployment & Load-Testing
  • AWS, GCE, Docker, Terraform
  • Locust
• Actual Deployment
  • Kubernetes + Helm
  • Google Kubernetes Engine (GKE)

Contributors

• Joseph Chen (jchen42703)
• Benson Jin (Jinb2)