---
title: Quickstart
description: First receipt in under a minute.
---

# Quickstart

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

## 1. Install

```python
pip install agenko
```

```typescript
pnpm add @agenko/sdk
```

## 2. Init

```python
import agenko

agenko.init()
```

```typescript
import agenko from "@agenko/sdk";

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
```

```typescript
const handleTicket = agenko.check(async (ticket) => {
  return await process(ticket);
});
```

## 4. Gate before

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

```typescript
const deleteAccount = agenko.approve({ when: "irreversible" }, async (userId) => {
  await db.deleteUser(userId);
});
```

## 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](https://github.com/arovi-labs), 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](/installation) if you want self-host
- [`init()`](/init) for env vars and auto-detect
- [Receipts](/receipts) for verdicts

## Agent instructions

This page: https://docs.agenko.app/quickstart.md

Fetch `/llms.txt` for the full index. Search: `GET /api/search-docs?query=...`
