PaTz โ€” Physics-Aware Transformer with eXplainability
โ— API Offlinepatz_env

System Architecture

LOCAL

Full-stack research platform running entirely on localhost. No cloud dependencies.

๐Ÿ
patz_env (conda)

Python 3.11.9 ยท PyTorch 2.4.1+cu124 ยท CUDA 12.4 ยท fair-esm ยท captum ยท mlflow ยท hydra-core ยท rdkit

โš™
FastAPI Backend

localhost:8007 ยท 20+ REST endpoints + WebSocket /ws/system /ws/training ยท serves static frontend ยท uvicorn ASGI

โš›
Next.js Frontend

localhost:3007 ยท Next.js 14.2 ยท React 18 ยท TypeScript ยท Tailwind CSS v3 ยท Plotly.js ยท rewrites /api/* โ†’ :8007

๐Ÿ—„
Data Layer

data/processed/ โ€” dataset_summary.json, split_manifest.json ยท results/ โ€” test_results.json, xai_results.json, screening_results.csv

๐Ÿ“Š
MLflow Tracking

mlruns/0/ โ€” 15 experiment runs ยท meta.yaml + metrics/ + params/ per run ยท no MLflow server needed (direct file read)

โš™
Configs (Hydra)

configs/model/patz.yaml + configs/training/default.yaml + configs/data/hiv_tb.yaml ยท YAML editable from UI

๐Ÿ’ป
Hardware

NVIDIA RTX 3050 6GB VRAM ยท Windows 11 ยท 16GB RAM ยท PyCharm IDE ยท conda environment

Port Map
ServicePortProtocol
FastAPI backend8007HTTP + WebSocket
Next.js frontend3007HTTP (dev mode)
/api/* rewrites8007Next.js proxy
/ws/* rewrites8007WebSocket upgrade