Skip to content

NetBox SDK

SDK-first NetBox toolkit for Python, the terminal, and Textual UIs.

netbox-sdk is built as three sibling packages:

  • netbox_sdk — standalone NetBox REST SDK
  • netbox_cli — Typer-powered CLI
  • netbox_tui — Textual-powered TUI

The repository ships three public surfaces:

  • netbox_sdk for Python integrations
  • nbx for CLI workflows
  • multiple Textual TUIs for browsing, debugging, and guided command execution

The SDK package itself exposes three layers:

  • NetBoxApiClient for low-level async HTTP control
  • api() / Api for the async facade layer
  • typed_api() for the versioned typed client backed by committed Pydantic models

The current typed SDK release lines are NetBox 4.6, 4.5, 4.4, and 4.3, plus 4.7 as an opt-in preview line. Continuous integration exercises the live-NetBox suite against v4.6.6, v4.6.3, v4.6.2, and v4.5.10.

Documented release

This site documents the netbox-sdk 0.0.11 source candidate. The latest final release on the default PyPI index is 0.0.11; use ==0.0.11 for a reproducible normal-index install. Release candidates are validated through an access-controlled package registry, TestPyPI, and source artifacts, not published to the default PyPI index.

  • SDK

    from netbox_sdk import api, typed_api

    SDK Guide

  • CLI

    nbx dcim devices list
nbx dcim devices get --id 1

    CLI Guide

  • TUI

    nbx tui
nbx demo tui --theme dracula

    TUI Guide

  • Quick Start

    pip install 'netbox-sdk[all]'
pip install 'netbox-sdk[all]==0.0.11'

nbx init
nbx dcim devices list

    Quick Start

Product split

  • SDK docs focus on importable Python APIs, request layers, authentication, and versioned typed clients.
  • CLI docs focus on the nbx command tree, dynamic commands, GraphQL, demo profile, and captured command examples.
  • TUI docs focus on the main browser, developer workbench, CLI builder, logs viewer, and Django model browser.

Contributor standard

uv sync --dev --extra cli --extra tui --extra demo
uv run pre-commit install --hook-type pre-commit --hook-type pre-push
uv run pre-commit run --all-files
uv run pytest