> ## Documentation Index
> Fetch the complete documentation index at: https://docs.transluce.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install the Docent SDK and coding agent plugin

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](https://claude.com/claude-code) or [Codex](https://help.openai.com/en/articles/11096431) installed.

## Instructions

<Steps>
  <Step title="Create your Docent account">
    Create an account at [docent.transluce.org](https://docent.transluce.org/signup) and sign in.
  </Step>

  <Step title="Install the Docent SDK">
    The SDK lets generated scripts call Docent from your project. We recommend using `uv`.

    Install it in your project:

    ```shell theme={null}
    cd your-project
    uv init && uv add docent-python
    ```
  </Step>

  <Step title="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.

    <Tabs>
      <Tab title="Claude Code">
        Add the Transluce marketplace, then install the Docent plugin:

        ```shell theme={null}
        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.

        <sub>*To update later, run `claude plugin update docent@transluce-plugins`.*</sub>
      </Tab>

      <Tab title="Codex">
        Add the Transluce marketplace, then install the Docent plugin:

        ```shell theme={null}
        codex plugin marketplace add TransluceAI/codex-plugins
        codex plugin add docent@transluce-plugins
        ```

        Start a new Codex session after installation so the Docent skills and MCP tools are loaded.

        <sub>*To update later, run `codex plugin marketplace upgrade transluce-plugins`, then start a new Codex session.*</sub>
      </Tab>

      <Tab title="Other IDEs">
        Download the skill files directly and pass the file contents directly in your prompt context:

        * [Claude Code Docent SKILL.md](https://github.com/TransluceAI/claude-code-plugins/blob/main/plugins/docent/skills/docent/SKILL.md)
        * [Codex Docent SKILL.md](https://github.com/TransluceAI/codex-plugins/blob/main/plugins/docent/skills/docent/SKILL.md)
      </Tab>
    </Tabs>
  </Step>

  <Step title="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:

    ```shell theme={null}
    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](https://docent.transluce.org/settings/api-keys).
    2. Copy the key into `~/.docent/docent.env` as the value of `DOCENT_API_KEY`.
  </Step>
</Steps>

## Next steps

<CardGroup cols={2}>
  <Card title="Run your first analysis" icon="rocket" href="/analysis/quickstart">
    Identify model failures and compare performance on our sample Terminal-Bench data.
  </Card>

  <Card title="Ingest your data" icon="upload" href="/ingestion/quickstart">
    Load your own agent runs into Docent so you can analyze them.
  </Card>
</CardGroup>