Initial commit

Author: Tom-Notch

.dockerignore

@@ -0,0 +1,11 @@
+# Applies to build only, ignore everything by default
+**
+
+# Keep only files needed for build
+!docker-compose.yml
+!docker/
+!environment.yml
+!pyproject.toml
+!requirements-full.txt
+!requirements.txt
+!usf/

.env.example

@@ -0,0 +1,38 @@
+# .env.example
+# Copy this file to .env and fill in your own values:
+#   cp .env.example .env
+#
+# .env is gitignored and will NOT be committed.
+
+# ── Docker ───────────────────────────────────────────────────────────
+XSOCK=/tmp/.X11-unix
+XAUTH=/tmp/.docker.xauth
+AVAILABLE_CORES=$(($(nproc) - 1))
+
+DOCKER_USER=your_dockerhub_username
+BASE_IMAGE=ubuntu:24.04 # nvidia/cuda:12.9.1-cudnn-devel-ubuntu24.04
+IMAGE_NAME=usf
+IMAGE_USER=ubuntu
+IMAGE_TAG=latest
+TIME_ZONE=$(cat /etc/timezone 2>/dev/null || readlink /etc/localtime | sed 's|.*/zoneinfo/||')
+TIME_ZONE=${TIME_ZONE:-UTC}
+
+CONTAINER_NAME=${IMAGE_NAME}
+HOME_FOLDER=/home/${IMAGE_USER}
+CODE_FOLDER=${IMAGE_NAME}
+
+HOST_UID=$(id -u)
+HOST_GID=$(id -g)
+HOST=${HOST:-$(hostname)}
+HOSTNAME=${HOSTNAME:-$(hostname)}
+
+BUILDER=multi-platform
+
+# ── Dataset Paths (for Docker volume mounts) ─────────────────────────
+MNIST_DIR=./data/MNIST
+PANDORA_DIR=./data/PANDORA
+STANFORD2D3DS_DIR=./data/stanford2D3DS
+
+# ── Weights & Biases ─────────────────────────────────────────────────
+WANDB_API_KEY=your_wandb_api_key
+WANDB_ENTITY="your_wandb_entity"

.github/workflows/pre-commit.yml

@@ -0,0 +1,17 @@
+---
+name: pre-commit
+
+on:
+    pull_request:
+    push:
+        branches:
+            - '*'
+            - '*/*'
+            - '**'
+jobs:
+    pre-commit:
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v3
+            - uses: actions/setup-python@v3
+            - uses: pre-commit/action@v3.0.0

.github/workflows/test.yml

@@ -0,0 +1,28 @@
+---
+name: test
+
+on:
+    pull_request:
+    push:
+        branches:
+            - '*'
+            - '*/*'
+            - '**'
+
+jobs:
+    test:
+        runs-on: ubuntu-latest
+        steps:
+            - uses: actions/checkout@v4
+
+            - name: Free disk space
+              run: |
+                  sudo rm -rf /usr/local/lib/android /usr/share/dotnet /opt/ghc \
+                      /usr/local/share/powershell /usr/local/share/chromium \
+                      /usr/local/lib/node_modules /usr/share/swift
+                  sudo docker system prune -af
+
+            - name: Run tests
+              run: |
+                  docker compose -f tests/docker-compose.test.yml run --rm usf \
+                      -c "set -x && conda run -n usf uv pip install -e . --no-deps && conda run -n usf pytest tests/ -v"