39 lines
1.2 KiB
Markdown
39 lines
1.2 KiB
Markdown
# Step 1: environment-bootstrap-docs
|
|
|
|
## Read First
|
|
- /AGENTS.md
|
|
- /PLAN.md
|
|
- /PROGRESS.md
|
|
- /docs/HARNESS.md
|
|
- /docs/IMPLEMENTATION_PLAN.md
|
|
- /docs/TOOLCHAIN.md
|
|
- /requirements.txt
|
|
|
|
## Task
|
|
Document and optionally script the repo-local environment bootstrap flow.
|
|
|
|
Cover Conda Python 3.11, requirements install, CUDA smoke test, `pip check`, and Nougat help check.
|
|
|
|
## Sprint Contract
|
|
- Done means: environment setup instructions reflect the verified GTX 1070 Ti / torch 2.7.1+cu126 baseline.
|
|
- Hard thresholds: dependency pins remain consistent across README, TOOLCHAIN, and requirements; no unverified torch upgrade is introduced.
|
|
- Files owned: `README.md`, `docs/TOOLCHAIN.md`, optional `scripts/`, `PROGRESS.md`, phase index.
|
|
- Dependencies: MVP CLI docs.
|
|
|
|
## Acceptance Criteria
|
|
```powershell
|
|
python scripts\validate_workspace.py
|
|
.\venv\python.exe -m pip check
|
|
.\venv\Scripts\nougat.exe --help
|
|
```
|
|
|
|
## Verification
|
|
1. Run the acceptance commands where local environment is available.
|
|
2. Explain any skipped environment command in `PROGRESS.md`.
|
|
3. Update this phase index.
|
|
|
|
## Do Not
|
|
- Do not replace the single `venv` policy.
|
|
- Do not require `uv`.
|
|
- Do not change pins without official compatibility verification.
|