Installation

Set up the Curate-Me platform monorepo for local development.

Clone the Repository


git clone https://github.com/Curate-Me-ai/platform.git
cd platform

Frontend dependencies


npm install --legacy-peer-deps

The --legacy-peer-deps flag is required for React Native compatibility across the monorepo.

Backend dependencies


cd services/backend
poetry env use python3.11
poetry install

Python 3.11 or 3.12 is required. Python 3.13 and 3.14 are not yet supported due to dependency constraints.

Environment Variables

Create a .env file in services/backend/ with the following keys:


# LLM Provider API Keys (at least one required for gateway fallback)
ANTHROPIC_API_KEY=sk-ant-xxx
OPENAI_API_KEY=sk-xxx
DEEPSEEK_API_KEY=sk-xxx
GOOGLE_API_KEY=xxx
 
# Infrastructure
REDIS_URL=redis://localhost:6379
 
# MongoDB
MONGO_URI=mongodb://localhost:27017/
MONGO_DATABASE_NAME_B2B=curate_dashboard   # Dashboard + gateway database
 
# Gateway-specific
GATEWAY_DEFAULT_RATE_LIMIT=100
GATEWAY_DAILY_BUDGET_DEFAULT=50.0

For the dashboard frontend, create apps/dashboard/.env.local:


# apps/dashboard/.env.local
NEXT_PUBLIC_API_URL=http://localhost:8001
NEXTAUTH_SECRET=your-secret-here

Start the APIs

Start the gateway and dashboard API in separate terminals:


cd services/backend
 
# AI Gateway (core product — LLM proxy + governance)
poetry run uvicorn src.main_gateway:app --reload --port 8002
 
# B2B Dashboard API
poetry run uvicorn src.main_b2b:app --reload --port 8001

Start the dashboard frontend:


npx turbo dev --filter=dashboard

Docker Setup

Start the required infrastructure services with Docker Compose:


docker-compose up -d

This provisions:

Service	Port	Purpose
MongoDB	27017	Primary data store (dashboard + gateway database)
Redis	6379	Caching, rate limiting, cost accumulation

To stop all services:


docker-compose down

To reset data and start fresh:


docker-compose down -v
docker-compose up -d

Verifying the Setup

Run the test suite to confirm everything is wired correctly:


# All tests
npm run test
 
# Backend tests only
cd services/backend
poetry run pytest
 
# Unit tests only
poetry run pytest tests/unit/
 
# Gateway tests
poetry run pytest tests/gateway/