# Matimo AGDK

The Agent Governance Development Kit is a Python SDK for agents that run outside
Workbench, whether they are built on LangChain, Google ADK, CrewAI, AutoGen or
plain Python. It is MIT licensed and available on PyPI
(`pip install matimo-agdk`, Python 3.13 or newer).

## What it adds

- **Cryptographic identity.** The agent registers once and signs its requests
  with its own key.
- **Mandatory telemetry.** An agent that stops reporting is provably absent.
- **A check before every guarded tool call.** The call is checked against policy
  before it runs, with human approval when a policy requires it.
- **Framework adapters.** LangChain, Google ADK, CrewAI, AutoGen, and a generic
  wrapper for any callable.

## What it does not do

- It never runs your tools. Your code runs in your process.
- It never holds your model provider key. The platform resolves your provider
  credentials on its side.

## Behaviour worth knowing

- **Suspending an agent.** The next call that reaches Gateway is denied
  immediately. The SDK's own local check follows on a heartbeat, so it can lag
  by up to one heartbeat interval.
- **If the platform cannot be reached.** Tool checks fail closed by default. An
  optional, bounded fail-open mode is capped at five minutes.

## Works with

[Matimo Gateway](/docs/gateway). Governance features that depend on the platform
need an Enterprise workspace.

## Who it is for

Engineers who own an agent outside Workbench and have been asked by security to
prove it is controlled.

## Next step

Source code is at github.com/tallclub/matimo-agdk. For an Enterprise workspace
to connect it to, [contact us](/contact).