Installation¶
This page describes how to install the package. There exist two ways to install the application: manually or via Docker.
Tip
We recommend using Docker for installation, as it is the easiest way to get started with the application.
Manual Installation¶
Manually installing the application requires setting up both the backend and frontend dependencies. To install the application manually, you need to follow these steps:
Backend Dependencies¶
For installing the project’s backend dependencies, we recommend using uv as it operates very quickly. To install the project’s backend dependencies using uv, follow these steps:
Ensure that you have uv installed on your system (see here for installation instructions).
Clone the repository to your local machine using
git clone
.Navigate to the root directory of the repository.
Run
uv sync
. uv will then install all necessary dependencies and create a virtual environment in the.venv
folder at the root of the project.Activate the environment by running
source ./.venv/bin/activate
on Mac and Linux, or.venv\Scripts\activate
on Windows.
Frontend Dependencies¶
To install the project’s frontend dependencies, you need to have Node.js and npm installed on your system. To install the project’s frontend dependencies, follow these steps:
Ensure that you have Node.js and npm installed on your system.
Navigate to the
frontend
directory of the repository.Run
npm install
. This will install all necessary frontend dependencies.
Running the project¶
To run the project, locally you have to start the backend server and the frontend server. To start the backend server, open the shell of your choice and run the following command:
uv run uvicorn backend.main:app
This runs the backend server on port 8000
by default.
To start the frontend server, open another shell, navigate to the frontend
directory and run the following command:
npm run frontend
This runs the frontend server on port 3000
by default.
To access the application, open your web browser and navigate to http://localhost:3000.
Docker Installation¶
Installing the application via Docker is the easiest way to get started. To install the application via Docker, follow these steps:
Ensure that you have Docker installed on your system (see here for installation instructions).
Clone the repository to your local machine using
git clone
.Navigate to the root directory of the repository.
Build the Docker image by running the following command (make sure Docker is running):
docker compose up --build
Once the build is complete, the application will be running on port
3000
by default.