Commit ·
d22b376
1
Parent(s): 011c17d
docs: clarify notebook artifact requirement
Browse files- README.md +3 -0
- docs/FUSION_DESIGN_LAB_PLAN_V2.md +5 -2
- training/notebooks/README.md +2 -1
README.md
CHANGED
|
@@ -12,6 +12,8 @@ The repo is organized around one clear submission thesis:
|
|
| 12 |
|
| 13 |
Training is supporting evidence. The environment is the product.
|
| 14 |
|
|
|
|
|
|
|
| 15 |
## Current Status
|
| 16 |
|
| 17 |
This repository is the clean hackathon workspace. The detailed planning docs live in `docs/FUSION_DESIGN_LAB_PLAN_V2.md`, `docs/FUSION_DELIVERABLES_MAP.md`, and `docs/FUSION_NEXT_12_HOURS_CHECKLIST.md`.
|
|
@@ -106,6 +108,7 @@ uv sync --extra notebooks
|
|
| 106 |
- Recommended compute workspace: Northflank Jupyter Notebook with PyTorch on the team H100
|
| 107 |
- OpenEnv deployment target: Hugging Face Spaces
|
| 108 |
- Minimal submission notebook target: Colab
|
|
|
|
| 109 |
- Verifier of record: `constellaration.problems.GeometricalProblem`
|
| 110 |
- Environment style: fresh wiring in this repo, not a port of the old `ai-sci-feasible-designs` harness
|
| 111 |
- Northflank containers are ephemeral, so persistent storage should be attached before relying on saved models, caches, or fixture data
|
|
|
|
| 12 |
|
| 13 |
Training is supporting evidence. The environment is the product.
|
| 14 |
|
| 15 |
+
A trained model is optional for this repo's submission story. A public Colab notebook artifact is still required by the hackathon, and that notebook can stay evaluation-first if training evidence is weak.
|
| 16 |
+
|
| 17 |
## Current Status
|
| 18 |
|
| 19 |
This repository is the clean hackathon workspace. The detailed planning docs live in `docs/FUSION_DESIGN_LAB_PLAN_V2.md`, `docs/FUSION_DELIVERABLES_MAP.md`, and `docs/FUSION_NEXT_12_HOURS_CHECKLIST.md`.
|
|
|
|
| 108 |
- Recommended compute workspace: Northflank Jupyter Notebook with PyTorch on the team H100
|
| 109 |
- OpenEnv deployment target: Hugging Face Spaces
|
| 110 |
- Minimal submission notebook target: Colab
|
| 111 |
+
- Required notebook artifact: one public Colab notebook, even if it only demonstrates evaluation traces rather than a trained policy
|
| 112 |
- Verifier of record: `constellaration.problems.GeometricalProblem`
|
| 113 |
- Environment style: fresh wiring in this repo, not a port of the old `ai-sci-feasible-designs` harness
|
| 114 |
- Northflank containers are ephemeral, so persistent storage should be attached before relying on saved models, caches, or fixture data
|
docs/FUSION_DESIGN_LAB_PLAN_V2.md
CHANGED
|
@@ -41,6 +41,8 @@ We are submitting a clear, reproducible training environment for a constrained s
|
|
| 41 |
|
| 42 |
Training is supporting evidence. The environment is the product.
|
| 43 |
|
|
|
|
|
|
|
| 44 |
## 2. Locked Decisions
|
| 45 |
|
| 46 |
These decisions are now fixed unless a hard blocker appears:
|
|
@@ -86,7 +88,7 @@ The judging signal now implies four priorities:
|
|
| 86 |
The four visible artifacts remain:
|
| 87 |
|
| 88 |
1. HF Space environment
|
| 89 |
-
2. Colab notebook for evaluation or training
|
| 90 |
3. 1-minute demo video
|
| 91 |
4. Public repo and README
|
| 92 |
|
|
@@ -94,7 +96,7 @@ The primary compute workspace should be Northflank:
|
|
| 94 |
|
| 95 |
- Northflank Jupyter Notebook with PyTorch on the team H100 for development, verifier integration, baselines, and training/debugging
|
| 96 |
- HF Space as the hosted environment surface
|
| 97 |
-
- Colab as the minimal required public notebook artifact
|
| 98 |
|
| 99 |
But the evidence order is:
|
| 100 |
|
|
@@ -195,6 +197,7 @@ Use each surface for one clear purpose:
|
|
| 195 |
- remote `reset` and `step` endpoint for the final demo path
|
| 196 |
- Colab:
|
| 197 |
- minimal reproducible evaluation or training notebook required by the hackathon
|
|
|
|
| 198 |
|
| 199 |
Northflank-specific constraint:
|
| 200 |
|
|
|
|
| 41 |
|
| 42 |
Training is supporting evidence. The environment is the product.
|
| 43 |
|
| 44 |
+
A trained model is optional. The Colab notebook is still a required public artifact, and it can remain evaluation-first if training evidence is weak.
|
| 45 |
+
|
| 46 |
## 2. Locked Decisions
|
| 47 |
|
| 48 |
These decisions are now fixed unless a hard blocker appears:
|
|
|
|
| 88 |
The four visible artifacts remain:
|
| 89 |
|
| 90 |
1. HF Space environment
|
| 91 |
+
2. Required Colab notebook for evaluation or training
|
| 92 |
3. 1-minute demo video
|
| 93 |
4. Public repo and README
|
| 94 |
|
|
|
|
| 96 |
|
| 97 |
- Northflank Jupyter Notebook with PyTorch on the team H100 for development, verifier integration, baselines, and training/debugging
|
| 98 |
- HF Space as the hosted environment surface
|
| 99 |
+
- Colab as the minimal required public notebook artifact, even if it ships as an evaluation-first notebook instead of a training-first notebook
|
| 100 |
|
| 101 |
But the evidence order is:
|
| 102 |
|
|
|
|
| 197 |
- remote `reset` and `step` endpoint for the final demo path
|
| 198 |
- Colab:
|
| 199 |
- minimal reproducible evaluation or training notebook required by the hackathon
|
| 200 |
+
- the notebook itself is mandatory; a trained model inside it is not
|
| 201 |
|
| 202 |
Northflank-specific constraint:
|
| 203 |
|
training/notebooks/README.md
CHANGED
|
@@ -11,6 +11,7 @@ Recommended split:
|
|
| 11 |
|
| 12 |
- Northflank notebook: main compute workspace on the team H100
|
| 13 |
- Colab notebook: thin public artifact required by the hackathon
|
|
|
|
| 14 |
|
| 15 |
## Status
|
| 16 |
|
|
@@ -40,4 +41,4 @@ Runnable repo path:
|
|
| 40 |
- note: `training/notebooks/NORTHFLANK_SMOKE_NOTE.md`
|
| 41 |
- latest passing artifact example: `/home/jovyan/fusion-design-lab/smoke/northflank_smoke_20260308T023646Z.json`
|
| 42 |
|
| 43 |
-
The notebooks are supporting evidence for the environment, not the primary product.
|
|
|
|
| 11 |
|
| 12 |
- Northflank notebook: main compute workspace on the team H100
|
| 13 |
- Colab notebook: thin public artifact required by the hackathon
|
| 14 |
+
- trained model: optional; if training evidence is weak, the required Colab notebook can stay eval-first
|
| 15 |
|
| 16 |
## Status
|
| 17 |
|
|
|
|
| 41 |
- note: `training/notebooks/NORTHFLANK_SMOKE_NOTE.md`
|
| 42 |
- latest passing artifact example: `/home/jovyan/fusion-design-lab/smoke/northflank_smoke_20260308T023646Z.json`
|
| 43 |
|
| 44 |
+
The notebooks are supporting evidence for the environment, not the primary product. The required artifact is the notebook itself, not a trained model checkpoint.
|