main
md 1.37 KB

Local Development

Prerequisites

  • Java 17
  • Maven
  • Python 3.12+
  • Node.js 20+
  • Docker Desktop
  • k3d
  • kubectl
  • Helm

Validate the Foundation

mvn clean verify

python -m py_compile ai/research-engine/app/main.py
python -m py_compile ai/valuation-engine/app/main.py
python -m py_compile ai/ranking-engine/app/main.py
python -m py_compile ai/portfolio-optimizer/app/main.py

helm lint infrastructure/helm/ai-investment-platform

Run DEV Platform

.\platform.ps1 up DEV
.\platform.ps1 status DEV
.\platform.ps1 down DEV

The DEV command creates a local k3d cluster named ai-investment-dev and installs the Helm chart into the ai-investment namespace.

Spring Boot Local Ports

When services are run directly from an IDE or Maven without overriding SERVER_PORT, their local defaults are:

Service Port
api-gateway 8080
auth-service 8081
portfolio-service 8082
broker-service 8083
company-service 8084
research-service 8085
recommendation-service 8086
risk-service 8087
notification-service 8088

Container and Helm deployments can override these through SERVER_PORT.

Local LLM Option

DEV configuration supports Ollama via:

AIP_LLM_PROVIDER=ollama
AIP_OLLAMA_BASE_URL=http://ollama:11434

No model is pulled or called in the foundation iteration.