Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.

1. 1

   Clone the repository

   The repo uses git submodules, so the clone fetches them too.

   git clone --recurse-submodules https://github.com/josehelioaraujo/comprai.git
   cd comprai

   Copy
2. 2

   Install the required runtimes

   Node.js LTS (no version pinned), .NET SDK

   # needs nvm: https://github.com/nvm-sh/nvm
   nvm install --lts
   sudo apt install dotnet-sdk-8.0  # Ubuntu 22.04+; other distros: https://learn.microsoft.com/dotnet/core/install/linux

   Copy
3. 3

   Configure environment variables

   Fill in secrets: NEXTAUTH_SECRET, POSTGRES_PASSWORD, DD_API_KEY, NEW_RELIC_LICENSE_KEY, NEW_RELIC_USER_KEY, ML_CLIENT_SECRET, SHOPIFY_ACCESS_TOKEN, RESEND_API_KEY

   cp .env.example .env

   Copy
4. 4

   Start backing services

   Needs: PostgreSQL, Redis, Kafka, RabbitMQ

   # needs Docker Engine: https://docs.docker.com/engine/install/
   docker compose -f docker-compose.yml up -d

   Copy

   If you see Cannot connect to the Docker daemon: start Docker Desktop (or the Docker service) first.
5. 5

   Install dependencies

   npm ci
   dotnet restore comprai.sln
   dotnet build comprai.sln

   Copy
6. 6

   Run the tests

   dotnet test comprai.sln

   Copy