# AI Consciousness Calculator

> Credence calculator for AI consciousness after Butlin et al. (2023). Stateless JSON API; a web UI for people; share links carry state between the two.

Full documentation with request/response JSON schemas: https://calculator.forconsciousness.com/llms-full.txt

## Endpoints

- GET https://calculator.forconsciousness.com/api/v1/framework — The paper's theories and indicators, with descriptions, prerequisites, default base rates and necessities, the default worldview, and the citation.
- GET https://calculator.forconsciousness.com/api/v1/examples — Built-in scenarios adapted from the paper's case studies (Transformer LLM, Perceiver IO, PaLM-E, virtual rodent, AdA), with their assessments under the default worldview.
- POST https://calculator.forconsciousness.com/api/v1/assess — Assess one scenario. Returns everything the UI shows: estimate, interval, prior, per-theory table, per-indicator posteriors and what-ifs, the leverage ranking (what would change it most), warnings, and a markdown narrative.
- POST https://calculator.forconsciousness.com/api/v1/sweep — Vary one parameter (a rating, a theory credence, computational functionalism, a base rate or a necessity) over a list of values and get the estimate at each. Use it to answer 'how much does X matter?'.
- POST https://calculator.forconsciousness.com/api/v1/compare — Assess two scenarios under the same worldview and list where their ratings disagree.
- POST https://calculator.forconsciousness.com/api/v1/share — Encode a scenario and worldview into a self-contained UI link a person can open. Nothing is stored; the link is the state.
- POST https://calculator.forconsciousness.com/api/v1/decode — Turn a share link (or its token) back into a scenario and worldview, so an agent can read what a person built in the UI.

## Reference

- Paper: https://arxiv.org/abs/2308.08708
- Web UI: https://calculator.forconsciousness.com/