Nominal Python Client

1.134.0 verified Mon Apr 27 auth: no python

Official Python client for the Nominal platform. Current version 1.134.0, rapid release cadence (multiple per week). Requires Python >=3.10, <4.

pip install nominal

Common errors

error ModuleNotFoundError: No module named 'nominal.client' ↓

cause Old import path for NominalClient.

fix

Use 'from nominal import NominalClient' instead.

error grpc.RpcError: [StatusCode.UNAUTHENTICATED] Authentication failed ↓

cause Missing or invalid token.

fix

Ensure NOMINAL_HOST and NOMINAL_TOKEN are correctly set.

Warnings

breaking v1.0.0 migration: The API was entirely rewritten; old code using nominal.v0alpha1 or protobuf-based clients will not work. ↓

fix Upgrade to >=1.0.0 and use the new NominalClient class.

gotcha Token authentication requires environment variables NOMINAL_HOST and NOMINAL_TOKEN. Missing either raises an authentication error without clear message. ↓

fix Set both environment variables before creating a client.

deprecated nominal.core.Something may be deprecated; check the documentation for the latest module structure. ↓

fix Check release notes for migration guides.

Imports

NominalClient

wrong

import nominal.client

correct

from nominal import NominalClient

Top-level class for API access

nominal
```
import nominal
```
Direct import for submodules like nominal.core

Quickstart

Authenticate and test connection to Nominal.

import os
from nominal import NominalClient

client = NominalClient(
    host=os.environ['NOMINAL_HOST'],
    token=os.environ['NOMINAL_TOKEN']
)
print(client.whoami())