# Hesperan

> Hesperan 1 is a decision API: it reads text or JSON state and answers typed questions — choice,
> yes/no probability (noul), ordinal score — with a probability for every outcome in about 100 ms.
> Plans with a monthly allowance of decisions, or pay-as-you-go per input token (output free). API base: https://api.hesperan.com. Auth: Authorization: Bearer hsp_...

## For coding agents
- [Agent skill (SKILL.md)](https://hesperan.com/skill/SKILL.md): complete guide to using the API from code and from agents
- [Skill download](https://hesperan.com/skill/hesperan.zip) · [installer](https://hesperan.com/install-skill.sh) · [install page](https://hesperan.com/agents)

## Docs
- [Quick start](https://hesperan.com/docs/quickstart): first request in curl, Python and TypeScript
- [Judgment types](https://hesperan.com/docs/judgments): choice, noul, score, JSON state, writing good questions
- [API reference](https://hesperan.com/docs/api): fields, response headers, health
- [OpenAPI 3.1](https://hesperan.com/openapi.json)
- [Errors and limits](https://hesperan.com/docs/errors): status codes, rate limits, retries
- [Plans and billing](https://hesperan.com/docs/billing): plans with a monthly allowance, or pay-as-you-go per input token

## Optional
- [Pricing](https://hesperan.com/pricing)
- [Benchmarks](https://hesperan.com/benchmarks)