first commit

2026-07-22 13:48:46 +08:00
commit c87751c3dc
2820 changed files with 726976 additions and 0 deletions
@@ -0,0 +1,48 @@
+# Runtime Install Reference
+
+## Base install
+
+```bash
+PYTHON_BIN=.venv/bin/python scripts/install.sh
+```
+
+This installs `simplecadapi==2.0.8` to the active Python environment.
+If `PYTHON_BIN` is not set, wrappers default to `python3` (fallback `python`).
+Installation is intentionally blocked for non-venv/system interpreters.
+
+## Install with Jupyter support
+
+```bash
+PYTHON_BIN=.venv/bin/python scripts/install.sh --with-jupyter
+```
+
+## Upgrade package
+
+```bash
+PYTHON_BIN=.venv/bin/python scripts/install.sh -- --upgrade
+```
+
+Everything after `--` is forwarded to `uv pip install` (or `python -m pip install` fallback).
+
+## Validate runtime
+
+```bash
+PYTHON_BIN=.venv/bin/python scripts/with_skill.sh --check
+.venv/bin/python scripts/repl_bootstrap.py --check
+```
+
+## Activate skill paths in current shell
+
+```bash
+eval "$(scripts/with_skill.sh --print-env)"
+```
+
+## Add and import skill-local evolved case
+
+```bash
+scripts/add_new_case.sh path/to/new_case.py
+```
+
+```python
+from simplecad_self_evolve_cases.evolve import your_function_name
+```