Skip to content
Browse docs / PARADA

Run it locally

Install, run every service and test against real PostgreSQL.

Prerequisites

  • Node.js 18+ and npm 9+
  • Python 3.11 — only for the vision service
  • No PostgreSQL install and no Docker: packages/database runs an embedded PostgreSQL cluster for development

Start

bash
git clone https://github.com/E1yWrites/parada.git
cd parada
npm install
npm run dev   # database + API + admin + mobile

Copy each package's .env.example to .env first, and give the seed its own passwords (PARADA_SEED_ADMIN_PASSWORD, PARADA_SEED_USER_PASSWORD).

The vision service runs on its own:

bash
npm run setup -w @parada/vision    # creates the virtualenv
npm run dev -w @parada/vision      # FastAPI on port 8001
npm run camera -w @parada/vision   # camera runtime (USB / RTSP / file)

Ports

ServicePort
API4100
Admin web3000
Vision/OCR8001
Expo / Metro8082
Embedded PostgreSQL5442

Tests

The API and database suites run against real PostgreSQL, not mocks.

bash
npm run db:test:setup -w @parada/database
npm run test