Skip to content

Developer Runbook

karkir0003 edited this page Jun 29, 2022 · 11 revisions

Developer Runbook

This page contains information on running the application as a developer when you want to make local changes

Deep Learning Playground Onboarding

Introduction

Welcome to the Deep Learning Playground project team (a DSGT Content Project). This

team's aim is to create an interactive playground for people to build and test their

machine learning and deep learning models in a quicker way. We are constructing a web

application that allows for users to drag and drop their layers (for deep learning),

set the optimizer and relevant parameters, upload their dataset and click the train

button. Once the train buttion is clicked, then the deep learning model is trained and

relevant performance metrics are outputted. Our product is essentially a low-code/no-

code solution to democratizing access to deep learning and machine learning.

Onboarding Instructions

As we are more than elated to have you join this impactful team, we want to make your

onboarding process as smooth as possible.

  1. Join this Discord Group. I guess you already did this step haha :)

  2. Under the #github-accts channel in Discord, include your Github username so that Karthik can add you.

  3. Clone the Deep Learning Playground Repository/Codebase using the command git clone https://github.com/karkir0003/Deep-Learning-Playground.git

  4. cd Deep-Learning-Playground to get into the root directory of the project

  5. Install Anaconda if you haven't at this link

  6. Open Anaconda Prompt.

  7. Navigate to the Deep-Learning-Playground project directory with the help of cd

  8. cd conda

  9. conda env create -f environment.yml . This command creates the Anaconda Environment you will be using for developement. The environment.yml file ensures that we all have a consistent development environment and is generally good practice

  10. cd ../. (get out of the conda subdirectory)

  11. cd backend . You will now be in the backend folder

  12. python driver.py . This will fire up a Flask service for which the frontend will interface with the backend

Now, our project is a web-app after all, so where's the frontend you may ask??? Well, follow these instructions to run the frontend

  1. Open Git CMD (but keep your Anaconda Prompt terminal running). Make sure that you are in the root directory of Deep-Learning-Playground

  2. cd frontend/playground-frontend

  3. If you haven't, install NPM at this link

  4. npm install . If you see warnings (in yellow), you're good. If you see "red warnings", please post in the Discord with a screenshot of your error message

  5. npm start . Development server on localhost:3000 will start up. You should be seeing a drag and drop and some dropdowns along with a train button.

Once you complete the onboarding, please DM Karthik in Discord with a screenshot of

the website run on your localhost:3000

Tech Stack

Below are the tools/technologies we use

  • Python
  • React.js
  • Flask
  • AWS (ECS + Fargate, ECR, EC2, Route53, Load Balancer)
  • Docker
Clone this wiki locally