---
title: Installation
description: Install the Pictograph SDK and its optional extras (CLI, agents, cache, telemetry).
section: Get Started
order: 0
---
## Requirements

- **Python 3.10+** (3.11+ recommended). Tested on 3.10–3.13.
- A Pictograph account and an API key (see [Quick Start](/docs/quick-start.md)).

## Install

```bash
pip install pictograph
```

Published on PyPI: [`pictograph`](https://pypi.org/project/pictograph/). The base install gives you the SDK Client, every resource, the agent toolkit, and the bundled `pictograph-cv` Skill.

## Optional extras

| Extra | What it adds | Install |
|---|---|---|
| `cli` | `pictograph` command (Typer + Rich) | `pip install 'pictograph[cli]'` |
| `agents` | Claude Agent SDK + openai-agents adapters | `pip install 'pictograph[agents]'` |
| `cache` | Local SQLite response cache (aiosqlite) | `pip install 'pictograph[cache]'` |
| `telemetry` | OpenTelemetry SDK for SDK calls | `pip install 'pictograph[telemetry]'` |
| `all` | Everything above | `pip install 'pictograph[all]'` |

Pillow is included in the base install (used to extract image dimensions
client-side during upload).

## Verify

```python
from pictograph import Client, REGISTRY, __version__

print(f"pictograph v{__version__}")
print(f"{len(REGISTRY)} agent tools registered")
```

Expected output:

```
pictograph v1.x.x
28 agent tools registered
```

## CLI verify

```bash
pictograph --version
pictograph --help
```

## Editable install (contributors)

```bash
git clone https://github.com/pictograph-labs/pictograph-sdk
cd pictograph-sdk
pip install -e '.[dev,cli,agents,cache,telemetry]'
pytest
```

## Next

- [Quickstart](/docs/quick-start.md) — run an end-to-end pipeline in five minutes
- [Authentication](/docs/authentication.md) — API key resolution and roles
- [Workflows](/docs/workflows.md) — the headline upload / annotate / train helpers