Skip to content

Local development

Per-product bring-up. Exhaustive env lists live in each service README / appconfig.py — do not paste secrets here.

Fraud

cd fraud-detection-ai-backend
poetry install
# .env: PYTHON_ENV, PROJECT_ID, REGION, APP_BACKEND_API,
#       AI_PRIVATE_KEY, BACKEND_PUBLIC_KEY, DB_CREDENTIALS (or DB_*), …
poetry run uvicorn src.app:app --reload --port 8080
curl -s http://localhost:8080/health

Stream services (separate terminals):

cd fraud-detection-ai-backend-stream/ml_service && poetry install && poetry run uvicorn src.app:app --port 8080 --reload
cd ../rule_service && poetry run uvicorn src.app:app --port 8081 --reload
cd ../case_management_service && poetry run uvicorn src.app:app --port 8082 --reload

Generate throwaway RSA keypairs for local JWT as described in the stream README.

KYC / KYB

cd kyc-kyb-ai-backend
poetry install
export GOOGLE_APPLICATION_CREDENTIALS=/path/to/sa.json
poetry run uvicorn src.app:app --reload
# http://localhost:8000/docs

Heavy face/ML deps may require the project Docker image on some laptops.

Banking Reconciliation

cd banking-reconciliation-ai-backend
make run-all
# or: make run-ingestion / make run-reconciliation-engine / …

Needs GCP credentials, BigQuery dataset, Redis, and (for non-local modes) Pub/Sub. APP_ENVIRONMENT=local avoids worker fan-out.

This documentation site

cd platform-docs
source .venv/bin/activate
mkdocs serve -a localhost:8001
mkdocs build --strict