Skip to main content
This guide will help you install the Docent SDK, add the Docent plugin to your coding agent, and generate an API key.

​
Before you begin

Have Claude Code or Codex installed.

​
Instructions

1

Create your Docent account

Create an account at docent.transluce.org and sign in.
2

Install the Docent SDK

The SDK lets generated scripts call Docent from your project. We recommend using uv.Install it in your project:
cd your-project
uv init && uv add docent-python
3

Install the coding agent plugin

The coding agent plugin gives your agent the Docent-specific workflow instructions and tools it needs to ingest data and run analyses.
Add the Transluce marketplace, then install the Docent plugin:
claude plugin marketplace add TransluceAI/claude-code-plugins
claude plugin install docent@transluce-plugins
Restart Claude Code after installation. Type / inside your Claude Code session to verify that /docent is available.To update later, run claude plugin update docent@transluce-plugins.
4

Add your API key to `~/.docent/docent.env`

Create the default global config file at ~/.docent/docent.env. The SDK also supports project-level docent.env files in your workspace or parent directories when you need a local override:
mkdir -p ~/.docent
cat <<'EOF' > ~/.docent/docent.env
DOCENT_API_KEY=<YOUR_API_KEY>
DOCENT_DOMAIN=docent.transluce.org
EOF
Then generate a Docent API key and paste it into that file:
  1. Create a new API key in Settings.
  2. Copy the key into ~/.docent/docent.env as the value of DOCENT_API_KEY.

​
Next steps

Run your first analysis

Identify model failures and compare performance on our sample Terminal-Bench data.

Ingest your data

Load your own agent runs into Docent so you can analyze them.