start-individual.md

← Back to Main README

Start Individual Services Guide

Client Setup

• Navigate to the client directory:

  cd client

• If you haven't already, install Node.js and pnpm.

• Install dependencies using pnpm:

  pnpm install

Server Setup

• The authentication service uses the dotenv-java library to automatically load environment variables from your .env file.

• Ensure you have a .env file in the root of your project with the following content:

  JWT_SECRET=<your_jwt_secret>

  You can orient yourself by looking at how the .env.example file looks like in the project root.

• The application.properties file in server/authentication-service/src/main/resources/ uses a placeholder to read the secret:

  jwt.secret=${JWT_SECRET}

• You do not need to manually export environment variables. Simply run the authentication service as usual (e.g., ./mvnw spring-boot:run), and the secret will be loaded automatically.

  Note: The JWT secret must be in .env and available to the authentication service for authentication to work correctly.

LLM Service Setup

Make sure to create a .env file from the .env.example and add your API Key.

• Navigate to the genai directory:

  cd genai

• Install Dependencies:

  python3 -m venv .venv
  source .venv/bin/activate
  pip3 install -r requirements.txt

Running the Application

Start the Database

You can start the database using Docker Compose:

docker compose up postgres-db

Start the Client

From the project root, run:

cd client
pnpm dev

Open http://localhost:3000 with your browser to see the result.

Start the Server

To start the microservices individually, repeat in their respective directories (e.g., authentication-service, coursemgmt-service, upload-service):

cd authentication-service
./mvnw spring-boot:run

cd coursemgmt-service
./mvnw spring-boot:run

cd upload-service
./mvnw spring-boot:run

Start the LLM Service

• Using uvicorn directly:

  cd genai
  uvicorn main:app --host 0.0.0.0 --port 8084

• Using python3:

  cd genai
  python3 main.py

• Using Docker:

  cd genai
  docker build -t llm .
  docker run --env-file .env -p 8084:8084 llm