Installation

Requirements

• Python 3.10+ (3.11+ recommended). Tested on 3.10–3.13.
• A Pictograph account and an API key (see Quick Start).

Install

pip install pictograph

Published on PyPI: 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

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

pictograph --version
pictograph --help

Editable install (contributors)

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

Next

• Quickstart — run an end-to-end pipeline in five minutes
• Authentication — API key resolution and roles
• Workflows — the headline upload / annotate / train helpers