Biosimulations Platform

Monorepo for the biosimulations/platform stack. Hosts both the backend services and the webapp frontend, deployed together to Kubernetes.

Production API: https://biosim.biosimulations.org/docs

Layout

Directory	Purpose
backend/	Python FastAPI + Temporal worker services. See backend/README.md.
frontend/	Webapp + Express server (added in Phase 2).
kustomize/	Shared Kubernetes manifests and per-cluster overlays.
.github/workflows/	CI pipelines (path-filtered per service).

Quickstart

Backend:

cd backend
poetry install
poetry run uvicorn biosim_server.api.main:app --host 0.0.0.0 --port 8000
poetry run python -m biosim_server.worker.worker_main

See backend/README.md and backend/CLAUDE.md for full backend docs.

Build & deploy

Images are published to ghcr.io/biosimulations/platform-* (platform-api, platform-worker, platform-frontend). Tags use the form <arch>_<version>, e.g. amd64_0.4.0.

# Build and push backend images for amd64 + arm64 (reads version from backend/biosim_server/version.py)
bash kustomize/scripts/build_and_push.sh

# Apply an overlay
export KUBECONFIG=<path-to-kubeconfig>
kubectl kustomize kustomize/overlays/biosim-gke | kubectl apply -f -

License

See LICENSE.