Docs menu

Quickstart

First receipt in under a minute.

Copy-paste. No config object. First receipt in under a minute.

1. Install

python
pip install agenko

2. Init

python
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

python
@agenko.check
def handle_ticket(ticket):
    result = process(ticket)
    return result  # result._agenko_receipt has claimed, actual, verdict, hash

4. Gate before

python
@agenko.approve(when="irreversible")
def delete_account(user_id):
    db.delete_user(user_id)

5. Point at a project

bash
export AGENKO_API_KEY=agk_...
export AGENKO_HOST=http://localhost:8000   # default

Local 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

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

Before writing SDK code

  • Install the agent skill or read Agent skill
  • Read Best practices — what a good receipt looks like
  • Trust boundary: @check after, @approve before
  • init() — zero required args, never throws
  • Mark estimated: true until a check is a hard fact
  • Shipped vs backlog: Introduction status table

Page: Quickstart
HTML: https://docs.agenko.app/quickstart
Markdown: https://docs.agenko.app/quickstart.md