Final Year Project: Automated Generation of 3D Printed Maps

Getting started

Option 1: Running in docker

Requirements

• Docker for Windows, macOS, or linux
• On linux systems, make sure Docker Compose is installed.

Run the application

1. git clone git@github.com:owenbrooks/tactil.git
2. cd tactil/docker
3. docker-compose up
4. Go to http://127.0.0.1

Option 2: Building from source

Requirements

• Linux (ubuntu/arch)
• Python 3.9 (yay -S python39)
• pip (sudo pacman -S python-pip)
• virtualenv (pip install virtualenv)
• nodejs (sudo pacman -S nodejs / sudo apt install nodejs)
• npm (sudo apt install npm)

Environment Setup

1. git clone https://github.com/owenbrooks/tactil.git && cd tactil
2. python -m virtualenv --python=/usr/bin/python3.9 venv
3. source venv/bin/activate
4. pip install -r requirements.txt
5. cd ui
6. npm install

How to run

1. Run the flask API: ./api_start.sh
2. Run the react UI: ./ui_start.sh

The upload form can be found at http://127.0.0.1:3000

Credits

Home icon by Putri Apriliza