Bad Decisions

Bad Decisions is a reusable engine and service for fill-in-the-blank party card games. It provides a validated pack registry, a stateless REST API, a browser client, a terminal client, and CardDeck portable-pack archives.

The engine makes no network requests while serving a hand and never changes packs through the HTTP API. Prompt and response selectors are independent; the registry is loaded at startup and can be run with multiple workers.

Install

python -m pip install bad-decisions
bad-decisions --help
bad-decisions --oneshot

The cross-platform client is separate:

python -m pip install bad-decisions-client
regret health
regret deal

The configured hosted browser client is at /bad-decisions/web/.

Packs

Set BAD_DECISIONS_PACK_DIR to an absolute registry directory. It replaces the bundled registry and is loaded only at startup.

bad-decisions pack validate example.carddeck
bad-decisions pack init-registry /absolute/pack/registry
bad-decisions pack import example.carddeck /absolute/pack/registry

CardDeck 1 defines the portable format. Its ZIP validation rejects traversal, symlinks, unexpected members, checksum mismatches, oversized content, and dangerous compression ratios before any pack is written.

Bundled content retains its own provenance and licensing. In particular, the base pack is licensed CC BY-NC-SA 2.0; operators distributing it must honor those terms.

API

uvicorn bad_decisions.api:create_app --factory --host 127.0.0.1 --port 8000
curl http://127.0.0.1:8000/healthz
curl http://127.0.0.1:8000/v1/packs
curl 'http://127.0.0.1:8000/v1/round?packs=base'

/docs exposes OpenAPI documentation. Errors use a stable JSON envelope and request responses include a request ID.

Linux deployment

Bad Decisions is Linux-native for production deployment:

bad-decisions setup
sudo NGINX_SITE_CONFIG=/etc/nginx/sites-available/example.com \
  PUBLIC_BASE_URL=https://example.com/bad-decisions \
  ./deploy.sh

The deployer creates an unprivileged service account, immutable wheel releases, a bad-decisions.service unit, and optional loopback nginx proxy configuration. See DEPLOYMENT.md.

Development

.venv/bin/python -m pytest
PYTHONPATH=client/src .venv/bin/python -m pytest client/tests
bash -n deploy.sh
.venv/bin/python -m build .
.venv/bin/python -m build client

Release files for bad-decisions 1.0.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bad-decisions 1.0.4
File	Size	Uploaded
bad_decisions-1.0.4.tar.gz	72.6 kB	Sep 17, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for bad-decisions 1.0.4
File	Interpreter	ABI	Platform	Reset
bad_decisions-1.0.4-py3-none-any.whl 42.9 kB Sep 17, 2026	Python 3	none	any	Details

Total release size: 115.5 kB

Release files / bad_decisions-1.0.4.tar.gz

Download URL	bad_decisions-1.0.4.tar.gz
Size	72.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`0f9944ffa0c445badf60dcc63a78708c532054365f75b69a12486e636bcf809b`
BLAKE2b-256 checksum How to use checksums	`061b051ce30c8efa5ffea14e784d261eff16e6f6378793f848b11a664d9bc956`
Upload date	Sep 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.3`

Release files / bad_decisions-1.0.4-py3-none-any.whl

Download URL	bad_decisions-1.0.4-py3-none-any.whl
Size	42.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`5157553ec932629fa049b1fddf468f9abec70e54d01c777e0033d44b6b93f3f1`
BLAKE2b-256 checksum How to use checksums	`fccfbab1cf89c670913b592089b9486bc2943ae442aa25777a1d29336974c7e2`
Upload date	Sep 17, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.3`