OpenDivination

OpenDivination is an experiment in what happens when LLMs get divination tools.

It is built for two use cases:

• standard human/LLM divination sessions
• LLMs using divination for their own reflective thinking, brainstorming, and purpose-finding

The current SDK and CLI cover:

• tarot draws
• I Ching casts
• auditable entropy provenance
• one stable text-only tarot resonance mode
• coherence scoring (semantic similarity between question and drawn symbol)

The product surface is intentionally small:

• selection mode by default
• csprng by default
• QRNG and resonance are opt-in

Quickstart

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

Use the skills in this order:

• start with divination-setup to install or update OpenDivination and run first-run source setup
• then use divination for tarot draws, I Ching casts, source inspection, and provenance-aware results
• keep csprng as the default unless the user explicitly chooses QRNG or local hardware

Detailed skill docs:

• skills/AGENTS.md
• skills/divination-setup/SKILL.md
• skills/divination/SKILL.md
• skills/divination/references/cli.md

CLI

If you want to use OpenDivination directly without the skills:

uv tool install opendivination
opendivination setup
opendivination draw tarot --json
opendivination draw iching --method yarrow --json
opendivination sources --json

GitHub fallback:

uv tool install git+https://github.com/amenti-labs/opendivination.git

Python SDK:

pip install opendivination

If you prefer `pipx`, it also works for non-system Python installs.

`opendivination setup` writes `~/.config/opendivination/config.json` and can keep the default `csprng` path, save remote QRNG credentials, or select detected local hardware.

Sources

OpenDivination keeps `csprng` as the default, but the experiment can also use remote and physical quantum paths:

...