CreativeEngineer commited on
Commit
d22b376
·
1 Parent(s): 011c17d

docs: clarify notebook artifact requirement

Browse files
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.