Agent governance
Developer control plane for policies, metering, and activity history.
Workspace: Local workspaceRole: AdminWelcome Preview

1. Generate an API key

One key per agent or environment

Go to API Keys and generate a workspace SDK key. Name it after the agent or environment that will use it. Gavrun shows the full key only once — copy it into your agent's environment right away.

# .env
GAVRUN_API_KEY=gk_...your key...
GAVRUN_AGENT_MANAGER_URL=https://api.gavrun.ai

2. Install the SDK

pip install gavrun

3. Include it in your code

Two lines
import gavrun

gavrun.configure(agent_name="my-agent", mode="observe")

4. What happens next

configure() reads GAVRUN_API_KEY and GAVRUN_AGENT_MANAGER_URL from your environment (or a local .env), registers the agent with this workspace on first run, and auto-instruments LangChain tool and model calls. The agent appears in the Agent Registry the moment it starts.

Start in mode="observe" to log decisions without blocking, then switch to mode="enforce" once a policy is assigned.