Installation

Requires Python 3.10+, tested on 3.10 through 3.13, and a Pictograph API key (see Quick start).

Install

pip install pictograph

Published on PyPI as 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
cli	The pictograph command
agents	Claude and OpenAI agent adapters
inference	Run trained models locally on ONNX Runtime
torch	The PyTorch runtime, and datasets.as_pytorch()
executorch	The ExecuTorch (.pte) runtime, for portable edge
tensorrt	The TensorRT (.engine) runtime, NVIDIA only
all	agents, cli, inference

pip install 'pictograph[cli,inference]'

all deliberately excludes torch, executorch and tensorrt - each pulls a large, hardware-specific runtime. Install those by name when you need them. Pillow is in the base install; it reads image dimensions locally during upload.

Verify

from pictograph import REGISTRY, __version__

print(__version__)          # 1.69.65
print(len(REGISTRY))        # 37 agent tools

pictograph --version

Extras are declared in pyproject.toml.

Editable install

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

Next

• Quick start - run an end-to-end pipeline in five minutes
• Authentication - API key resolution and roles
• Guides - upload, auto-annotate, tile, augment, train