Auto Discover
Agents register themselves the first time they run with a workspace API key — no manual onboarding.
1. Generate an API key
One key per agent or environmentGo 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 linesimport 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.