Opendivination divination-setup

Installs or updates OpenDivination, verifies the CLI, and runs first-run source setup including QRNG credentials and QCicada selection. Use when the user wants to set up OpenDivination, bootstrap the divination skill, save a persistent source, or prepare hardware entropy.

install

source · Clone the upstream repo

git clone https://github.com/amenti-labs/opendivination

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/amenti-labs/opendivination "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/divination-setup" ~/.claude/skills/amenti-labs-opendivination-divination-setup && rm -rf "$T"

manifest: skills/divination-setup/SKILL.md

source content

Divination Setup

Install and configure OpenDivination.

Prefer the bundled helper after the CLI is available:

python3 scripts/run_opendivination.py --check

Use When

the user wants to install or update OpenDivination
the user wants to set up the divination skill bundle for first use
the user wants to run
```
opendivination setup
```
the user wants a persistent default source
the user wants to save an ANU or Outshift API key
the user wants to prepare QCicada or another local hardware source
the user wants to verify whether QRNG, hardware, or resonance prerequisites are ready

Use

divination

instead when the CLI is already ready and the user just wants a draw, cast, or source inspection.

Working Style

keep going unless a real user choice is required
prefer fixing environment issues directly over telling the user to do it
prefer
```
uv tool install
```
/
```
uv tool upgrade
```
when
```
uv
```
is available
keep
```
csprng
```
as the default unless the user explicitly chooses QRNG or local hardware
prefer
```
outshift
```
over
```
anu
```
when the user wants a remote QRNG and has no strong preference
prefer
```
qcicada
```
over
```
openentropy
```
when the user wants the strongest explicit local quantum path
never imply quantum entropy when the configured source is still
```
csprng
```

Setup Flow

Preflight

python3 --version
which opendivination || true

If OpenDivination is already installed, verify it:

opendivination version
python3 scripts/run_opendivination.py --check

Install or update the CLI

Preferred path with

uv

uv tool install opendivination
uv tool upgrade opendivination

Published CLI:

python3 -m pip install pipx
python3 -m pipx install opendivination
python3 -m pipx upgrade opendivination

GitHub fallback:

python3 -m pipx install git+https://github.com/amenti-labs/opendivination.git

Local repo:

python3 -m pip install -e ".[dev]"

pipx

is unavailable and a regular Python install is acceptable:

python3 -m pip install opendivination

Optional QCicada hardware path:

python3.13 -m pipx install --python python3.13 'opendivination[hardware]'

Install the portable skills when needed

npx skills add amenti-labs/opendivination --skill divination-setup --skill divination

Choose the source path

Interactive setup:

python3 scripts/run_opendivination.py setup

Structured setup:

python3 scripts/run_opendivination.py setup --json
python3 scripts/run_opendivination.py setup --source-profile computer --json
python3 scripts/run_opendivination.py setup --source-profile remote_quantum --qrng-provider outshift --api-key YOUR_KEY --json
python3 scripts/run_opendivination.py setup --source-profile local_hardware --hardware-source qcicada --json

Ask the user which path they want:

regular computer RNG
remote QRNG
local hardware QRNG

For remote QRNG:

prefer
```
outshift
```
unless the user explicitly wants
```
anu
```
if they need a key, tell them to go to
```
https://qrng.outshift.com/
```
, create an account, and get an API key
simplest secret-handling path: ask them to set
```
OUTSHIFT_QRNG_API_KEY
```
and tell you when it is ready
if they prefer to paste the key directly, store it through
```
setup
```

Use a short prompt for the env-var path:

Set OUTSHIFT_QRNG_API_KEY in your shell and tell me when it's ready.

For local hardware:

check availability with

python3 scripts/run_opendivination.py sources --json

prefer
```
qcicada
```
when present
if no hardware source is detected, keep
```
csprng
```
and explain why

Verify

python3 scripts/run_opendivination.py version
python3 scripts/run_opendivination.py sources --json
python3 scripts/run_opendivination.py draw tarot --json

When provenance or trust matters, always report:

```
provenance.source_id
```
```
provenance.is_quantum
```

Reference

After setup is complete, use the

divination

skill for actual readings and symbolic interpretation.