quantum-lab

# Quantum Lab

## Overview
Run quantum_lab repo commands inside the preexisting qiskit venv. Prefer the helper scripts in `scripts/` so the venv and repo root are always set.

## Command List (full)
Use `<SKILL_DIR>` as the folder where this skill is installed (e.g., `~/clawd/skills/quantum-lab`).

- `bash <SKILL_DIR>/scripts/qexec.sh python quant_math_lab.py`
- `bash <SKILL_DIR>/scripts/qexec.sh python qcqi_pure_math_playground.py`
- `bash <SKILL_DIR>/scripts/qexec.sh python quantum_app.py`
- `bash <SKILL_DIR>/scripts/qexec.sh python quantum_app.py self-tests`
- `bash <SKILL_DIR>/scripts/qexec.sh python quantum_app.py playground`
- `bash <SKILL_DIR>/scripts/qexec.sh python quantum_app.py notebook notebooks/SomeNotebook.ipynb`
- `bash <SKILL_DIR>/scripts/qexec.sh python -m quantumapp.server --host 127.0.0.1 --port 8000`

## Command List (short)
Use these for quick Telegram/OpenClaw commands. Both `gl` and `ql` are supported and equivalent.

- `bash <SKILL_DIR>/scripts/gl self-tests`
- `bash <SKILL_DIR>/scripts/gl playground`
- `bash <SKILL_DIR>/scripts/gl app`
- `bash <SKILL_DIR>/scripts/gl lab-tests`
- `bash <SKILL_DIR>/scripts/gl playground-direct`
- `bash <SKILL_DIR>/scripts/gl notebook notebooks/SomeNotebook.ipynb`
- `bash <SKILL_DIR>/scripts/gl web 8000`

## Shorthand Handling
If the user types `gl ...` or `ql ...` without a full path, always expand it to the full command:
- `gl <args>` → `bash <SKILL_DIR>/scripts/gl <args>`
- `ql <args>` → `bash <SKILL_DIR>/scripts/ql <args>`

## Notes
- Repo root default: `$HOME/work/quantum_lab` (override with `QUANTUM_LAB_ROOT`).
- Venv default: `~/.venvs/qiskit` (override with `VENV_PATH`).
- If dependencies are missing: `bash <SKILL_DIR>/scripts/qexec.sh pip install -r requirements.txt`.