---
title: CLI Installation
description: Install the CodeDD CLI, verify setup, and complete first-time authentication
category: CodeDD CLI
order: 1
---

# CLI Installation

## Requirements

- Python **3.10+** (3.10–3.13)
- CodeDD account with CLI token from **Account → CLI Access**
- At least one LLM API key (Anthropic, OpenAI, Gemini, or Grok)

### System requirements

File auditing runs on your machine. Peak RAM depends on **concurrency**, not total file count.

| Profile | RAM (free) | CPU | Notes |
|---|---|---|---|
| Minimum | 4 GB | 2 cores | Concurrency 1–4; small repos |
| Recommended | 8 GB | 4 cores | Concurrency 8–16; typical M&A repos |
| Large repos | 16 GB+ | 8+ cores | Concurrency 24–75; monorepos 5k+ files |

Disk: space for Git checkouts in scope plus `~/.codedd` checkpoints (usually under 100 MB).

Network: stable HTTPS to your LLM provider and `api.codedd.ai`.

## Install

```bash
pip install codedd-cli
```

From source:

```bash
git clone https://gitlab.com/codedd1/codedd-cli
cd codedd-cli
pip install -e .
```

## Verify and log in

```bash
codedd --version
codedd auth login --token <your_cli_token>
codedd auth status
```

For CI, set `CODEDD_API_TOKEN` instead of keychain storage.

## Next step

[CodeDD CLI Guide](/documentation/codedd-cli-guide) — scope selection, audit execution, and remediation.

For billing and account help: [Common Questions](/documentation/common-questions-account-billing-support).