# Verathos Decide

> Open-weight decision models on Bittensor: send a state and typed questions (yes/no, choice, scale) to POST /v1/systemone and get a probability for every option, with a signed receipt from the miner that answered. System One API compatible.

- API base URL: https://testnet.verathos.ai. Keys go in `Authorization: Bearer <key>`; a person signs in at https://testnet.verathos.ai/login and creates them at https://testnet.verathos.ai/account/keys.
- Models, prices and limits, as JSON without a key: https://testnet.verathos.ai/v1/models; their live state: https://testnet.verathos.ai/v1/status.
- Bittensor subnet 96 (finney): miners serve the models on NVIDIA GPUs, validators check them, and any registered hotkey except the subnet owner's can refer users with codes.
- Installer for miners and validators: `curl -LsSf https://testnet.verathos.ai/install.sh | bash -s -- miner` (or `validator`).
- Every docs page in one file: https://testnet.verathos.ai/llms-full.txt. Each docs page as Markdown: its address with .md.
- Agent skills (agentskills.io format): verathos-api, verathos-miner, verathos-referrals, verathos-validator, at https://testnet.verathos.ai/skills/<name>/SKILL.md; `npx skills add https://testnet.verathos.ai` installs them.
- Help: info@verathos.ai (with the `X-Request-Id` of a failing request).

## Get started

- [Overview](https://testnet.verathos.ai/docs/index.md): What a decision model is, the three question types, and when not to use one.
- [API reference](https://testnet.verathos.ai/docs/api.md): POST /v1/systemone, GET /v1/models, GET /v1/status and the site's GET /api/status/history.
- [Quickstart](https://testnet.verathos.ai/docs/quickstart.md): Create a key, send a request, and read the answer.
- [Authentication](https://testnet.verathos.ai/docs/authentication.md): API keys, how to send them, and how revocation works.
- [AI agents](https://testnet.verathos.ai/docs/agents.md): The docs as Markdown for AI agents, and agent skills that use the API or set up a miner, a validator or referral codes.

## Concepts

- [State](https://testnet.verathos.ai/docs/state.md): What to put in the state, its size limit, and images for a model that reads them.
- [Questions](https://testnet.verathos.ai/docs/questions.md): yes/no, choice and scale questions, and how to word them.
- [Reading answers](https://testnet.verathos.ai/docs/answers.md): Probabilities, the derived fields, and how to set thresholds.
- [Receipts](https://testnet.verathos.ai/docs/receipts.md): What the signed receipt in every answer proves, and how answers are checked.

## Guides

- [Migrate from System One](https://testnet.verathos.ai/docs/migrate-system-one.md): Move a System One client to Decide by changing the base URL, the key and the model id; Clef requests with images.

## Mining and validating

- [Run a miner](https://testnet.verathos.ai/docs/mining.md): Serve the subnet's decision models on your GPUs and earn by the capacity you prove. One command installs everything.
- [Run a validator](https://testnet.verathos.ai/docs/validating.md): Set the subnet's weights, light (the auditor's verified results, no GPU) or full (check miners' answers against a reference). One command installs either.
- [Referral codes](https://testnet.verathos.ai/docs/referrals.md): Register referral codes for a registered hotkey, on a miner or with one uvx command anywhere, and follow what they bring.
- [Miner status](https://testnet.verathos.ai/docs/miners.md): Where to see how the validator scored your endpoints, and what each state means.

## Operations

- [Models and versions](https://testnet.verathos.ai/docs/models.md): The model list, what each entry says, and pinning.
- [Errors](https://testnet.verathos.ai/docs/errors.md): Status codes, error types, and what to do about each.
- [Rate limits](https://testnet.verathos.ai/docs/rate-limits.md): Request rates, bursts, and the deadline per request.
- [Limitations](https://testnet.verathos.ai/docs/limitations.md): Measured limits of the models, on text and on images, with dates.

## Agent skills

- [verathos-api](https://testnet.verathos.ai/skills/verathos-api/SKILL.md): Calls the Verathos Decide API (POST /v1/systemone, System One compatible), which answers yes/no, choice and scale questions about a text, JSON or image state with a probability for every option and a miner's signed receipt. Use when integrating Verathos Decide into code, choosing a model, writing questions, reading answers, or handling its errors, limits and credit.
- [verathos-miner](https://testnet.verathos.ai/skills/verathos-miner/SKILL.md): Sets up, checks, updates and removes a Verathos Decide miner on Bittensor subnet 96 (finney) with the one-command installer, on a Linux machine with NVIDIA GPUs. Use when asked to mine on Verathos or SN96, serve kev-4b, kev-9b or clef-flash, check a miner's services, logs, firewall or score, or fix a miner validators cannot reach.
- [verathos-referrals](https://testnet.verathos.ai/skills/verathos-referrals/SKILL.md): Registers, checks and moves Verathos Decide referral codes for a hotkey registered on Bittensor subnet 96, on a miner or with one uvx command on any machine that holds the hotkey (no GPU, no checkout), with verathos-miner referral. Use when asked to refer users to Verathos, create a referral code or link, see what a code brought, open the referral dashboard, or move codes to a new hotkey.
- [verathos-validator](https://testnet.verathos.ai/skills/verathos-validator/SKILL.md): Sets up, checks, updates and removes a Verathos Decide validator on Bittensor subnet 96 (finney) with the one-command installer, light by default (no GPU) or full with its own reference models. Use when asked to validate on Verathos or SN96, choose between light and full mode, or check a validator's weights, logs or stake.

## Optional

- [Whitepaper](https://testnet.verathos.ai/whitepaper.md): how the network serves the models, verifies answers and capacity, and pays miners
- [Source code](https://github.com/verathos-ai/verathos-decide): the miner, the validator and the gateway; the complete operator guides are its docs/MINING.md, docs/VALIDATING.md and docs/GATEWAY.md