Quickstart
First receipt in under a minute.
Copy-paste. No config object. First receipt in under a minute.
1. Install
pip install agenko2. Init
import agenko
agenko.init()init() takes zero required arguments, reads AGENKO_API_KEY / AGENKO_HOST from the environment, and never throws. Uninitialized = no-op.
3. Receipt after
@agenko.check
def handle_ticket(ticket):
result = process(ticket)
return result # result._agenko_receipt has claimed, actual, verdict, hash4. Gate before
@agenko.approve(when="irreversible")
def delete_account(user_id):
db.delete_user(user_id)5. Point at a project
export AGENKO_API_KEY=agk_...
export AGENKO_HOST=http://localhost:8000 # defaultLocal stack: cp .env.example .env && make dev in the Agenko repo, then open the console at http://localhost:3000.
Without an API key, the SDK still runs — it logs set AGENKO_API_KEY — then run your agent and does not crash your app.
Next
- Installation if you want self-host
init()for env vars and auto-detect- Receipts for verdicts
Agent instructions
This page is part of the Agenko documentation at docs.agenko.app. Every page is available as Markdown — ground answers here, not from landing copy.
Querying these docs
- Full index: docs.agenko.app/llms.txt · sections: llms-docs.txt, llms-sdk.txt, llms-integrations.txt
- This page as markdown: docs.agenko.app/quickstart.md
- Search API:
curl -sG "https://docs.agenko.app/api/search-docs" --data-urlencode "query=…"
Before writing SDK code
- Install the agent skill or read Agent skill
- Read Best practices — what a good receipt looks like
- Trust boundary:
@checkafter,@approvebefore init()— zero required args, never throws- Mark
estimated: trueuntil a check is a hard fact - Shipped vs backlog: Introduction status table