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

# Quickstart

> Install Darkplane on your GitHub organization and run your first readiness evaluation.

This guide walks you through installing Darkplane and getting your first readiness score.

## Prerequisites

* **GitHub organization:** You need admin access to install the Darkplane GitHub App.
* **A repository with CI:** Darkplane reads check runs, so at least one workflow should run on pull requests.

## Steps

<Steps>
  <Step title="Install the GitHub App">
    Go to the Darkplane app page and install it on your organization. Grant access to the repositories you want Darkplane to evaluate.

    <Warning>
      The app requires the `contents:read` permission. Without it, ingestion silently writes nothing.
    </Warning>
  </Step>

  <Step title="Sign in to Darkplane">
    Open the Darkplane app and sign in with your GitHub account. Repositories from your installation appear automatically.
  </Step>

  <Step title="Open a pull request">
    Darkplane evaluates every new pull request in connected repositories. Open one and watch the evaluation appear as a check run.
  </Step>

  <Step title="Review your readiness score">
    The repository overview shows your current level and what is blocking the next one.
  </Step>
</Steps>

## Next steps

* Read about [the six levels](/concepts/six-levels) to understand what your score means.
* Configure [repository settings](/guides/repository-settings) to tune gates per repository.