Skip to main content

agenko

The deterministic trust boundary for AI agents.

One line gives every agent action a cryptographic receipt and a deterministic gate before any irreversible move. No LLM inference — measured facts, provable audit, OTEL-native.


Installation

pip install agenko

Quick Start

import agenko

agenko.init()  # instrument is a backward-compat alias of init

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

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

Set AGENKO_API_KEY (and optionally AGENKO_HOST) in your environment — init() reads them and never throws.

What Agenko Provides

Primitive Description
Receipt (@check) Cryptographic proof of claimed vs. actual — deterministic, not LLM-inferred
Gate (@approve) Deterministic block before irreversible actions; only exceptions escalate
Tracing OTEL-native, every span, tool call, token, cost
Audit SHA-256 hash-chained log

Why deterministic matters

Most tools detect silent failures via LLM scoring or semantic drift — useful but not provable. Agenko's receipt is measured facts. We never sell an inference as a measurement. Grounding scores are always estimated: true.

Framework support

init() auto-detects and instruments loaded SDKs — OpenAI, Anthropic, LangChain, Mistral, Cohere, Bedrock, LiteLLM, LlamaIndex, CrewAI, Google GenAI. Import your framework, then call init():

import openai
import agenko

agenko.init()  # patches openai if already imported

Optional drop-in modules: agenko.openai, agenko.anthropic, agenko.langchain, and others.

Self-Host

git clone https://github.com/agenko-ai/agenko
cd agenko
cp .env.example .env
make dev

Open http://localhost:3000 for the console.

Links

License

Apache 2.0

Metadata

Release files for agenko 0.1.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for agenko 0.1.4
File Size Uploaded
agenko-0.1.4.tar.gz 399.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for agenko 0.1.4
File Interpreter ABI Platform
agenko-0.1.4-py3-none-any.whl Python 3 none any Details

Total release size: 432.5 kB

Release files / agenko-0.1.4.tar.gz

Download URL agenko-0.1.4.tar.gz
Size 399.8 kB
Tags Source
SHA-256 checksum
How to use checksums
26e4e47806cd91c50c9b17dc349d461f07695218aa19276985f47b6337d12c68
BLAKE2b-256 checksum
How to use checksums
84ecb558bd15157589a44ed61cf2b5ac64d36f5e29683d1f0fe4c9921164272d
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release files / agenko-0.1.4-py3-none-any.whl

Download URL agenko-0.1.4-py3-none-any.whl
Size 32.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
1dadfff00e660c443cea3e7c0b01d0a2f0aa020a2d2e9fa5634ab59ace5b45e5
BLAKE2b-256 checksum
How to use checksums
96ba30e738dde65e06589ce0fceff4a807b1d4bef1e125fb0c9c50e5c625bb25
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.14

Release history Release notifications | RSS feed

This release

0.1.4 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page