novant-python

Python SDK for the Novant API.

Full documentation at docs.novant.io/sdk/python.

Installation

pip install novant

Quick Start

from novant import NovantClient

client = NovantClient(api_key="ak_xxx")

# Get project info
proj = client.project()
print(proj.city)        # "Richmond, VA"
print(proj.tz)          # "New_York"

# List assets
for asset in client.assets():
    print(asset.name, asset.type)

# Read current values
for v in client.values(source_id="s.2"):
    print(v.id, v.val, v.status)

# Get trend data
for row in client.trends(point_ids=["s.2.4", "s.2.5"], date="2026-03-09"):
    print(row.ts, row.values)

Development

git clone https://github.com/novant-io/novant-python.git
cd novant-python
python3 -m venv .venv
source .venv/bin/activate
pip install --upgrade pip
pip install -e ".[dev]"

The dev extra installs pytest, build, and twine — everything needed for testing and publishing.

Testing

Tests are integration tests that run against the live Novant API. Place a test project's API key at secret/test.key, then:

pytest

Tests are skipped automatically if secret/test.key is missing.