Files
julius_baer_onboarding/README.md
2025-04-13 10:20:16 +02:00

1.7 KiB

julius_baer_onboarding

Project Setup Guide (Ubuntu Linux)

This project consists of a Python backend and a JavaScript frontend. The following instructions describe how to set up the development environment manually on Ubuntu.


Prerequisites

Install the following system dependencies:

  • Python 3.12
  • pip
  • virtualenv
  • Node.js (v16+)
  • npm
  • tesseract-ocr

🔧 Installation Steps

1. Install Python 3.12 and Required Tools

For Ubuntu 22.04+

sudo apt update
sudo apt install python3.12 python3.12-venv python3.12-dev

For Ubuntu 20.04

sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.12 python3.12-venv python3.12-dev

2. Install Tesseract OCR

sudo apt install tesseract-ocr

3. Install Node.js and npm

curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs

🚀 Project Setup

  1. Clone the repository
git clone https://github.com/NoeBerdoz/julius_baer_onboarding
cd julius_baer_onboarding
  1. Set up the Python virtual environment
python3.12 -m venv .venv
source .venv/bin/activate
pip install --upgrade pip
pip install -r requirements.txt
  1. Install frontend dependencies
cd frontend
npm install
cd ..

📁 Project Structure

  • requirements.txt — Python dependencies
  • .venv/ — Python virtual environment
  • frontend/ — JavaScript frontend (managed with npm)

🧪 Development Workflow

  • Activate the Python virtual environment:
source .venv/bin/activate
  • To run the frontend:
cd frontend
npm run dev
  • To run the backend:
python app.py