Skip to main content
This guide will walk you through installing all prerequisites and dependencies for the Tesis Rutas platform.

​
Prerequisites

Before you begin, ensure you have the following installed on your system:
1

Python 3.8 or higher

Verify your Python installation:
python --version
# or
python3 --version
If Python is not installed, download it from python.org
2

Node.js 18 or higher

Verify your Node.js installation:
node --version
If Node.js is not installed, download it from nodejs.org
3

Git

Verify Git is installed:
git --version
If Git is not installed, download it from git-scm.com

​
Clone the Repository

Clone the Tesis Rutas repository to your local machine: 
git clone <repository-url>
cd tesis-rutas
Replace <repository-url> with the actual repository URL provided by your team.

​
Backend Setup

The backend is built with FastAPI and requires Python dependencies.
1

Create a virtual environment (recommended)

Create and activate a Python virtual environment:
python -m venv venv
source venv/bin/activate
2

Install Python dependencies

Install all required packages from requirements.txt:
pip install -r requirements.txt
This will install:
  • FastAPI 0.121.1 - Modern web framework
  • Uvicorn 0.38.0 - ASGI server
  • PyMongo 4.15.3 - MongoDB driver
  • Cloudinary 1.44.1 - Media management
  • python-jose 3.5.0 - JWT authentication
  • bcrypt 5.0.0 - Password hashing
  • Pydantic 2.12.4 & pydantic-settings 2.11.0 - Configuration management
  • And other supporting libraries
3

Verify installation

Check that FastAPI is installed correctly:
python -c "import fastapi; print(fastapi.__version__)"

​
Frontend Setup

The frontend is built with React, Vite, and Tailwind CSS.
1

Navigate to frontend directory

cd frontend
2

Install Node.js dependencies

Install all required packages:
npm install
This will install:
  • React 19.2.0 - UI library
  • Vite 7.2.4 - Build tool
  • React Router 7.10.1 - Client-side routing
  • Tailwind CSS 4.1.18 - Utility-first CSS
  • Leaflet 1.9.4 & react-leaflet 5.0.0 - Interactive maps
  • Axios 1.13.2 - HTTP client
  • Radix UI components - Accessible UI primitives
  • Lucide React 0.561.0 - Icon library
  • And other UI/utility libraries
3

Verify installation

Check that the installation was successful:
npm list react vite

​
Verify Installation

After completing the setup, verify everything is working:
1

Test backend imports

From the root directory:
python -c "from src.config.settings import get_settings; print('Backend ready!')"
2

Test frontend build

From the frontend directory:
npm run build
This should complete without errors.
Before running the application, you need to configure environment variables. Continue to the Configuration guide.

​
Next Steps

Configuration

Set up environment variables and external services

Deployment

Deploy your application to production

Build docs developers (and LLMs) love

Get started for freeTalk to us