Skip to main content

USN - Unified State Network Architecture Library

A production-grade Python package implementing the Unified State Network (USN) architecture for autoregressive sequence modeling.

USN replaces attention mechanisms with a unified persistent state partitioned into semantic (vector) and relational (matrix) subspaces, achieving O(n) training complexity via associative parallel scan and O(1) inference memory via constant-size state.

Features

  • Novel state-space architecture with no attention mechanism
  • O(n) training via parallel associative scan
  • O(1) inference memory via constant-size persistent state
  • 4-level acceleration hierarchy (Triton → torch.compile → custom autograd → eager)
  • Single-file .usn serialization format
  • CLI interface for training, generation, and benchmarking

Installation

pip install USN

For development:

pip install USN[dev]

For CUDA acceleration:

pip install USN[cuda]

For all optional dependencies:

pip install USN[all]

Quick Start

import usn

# Create a model from a preset configuration
config = usn.USNConfig.tiny()
model = usn.create_model(config)

# Print model summary
print(model.summary())

License

MIT License - Copyright (c) 2024 BUEORM

Metadata

Release files for USN 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for USN 0.1.0
File Size Uploaded Provenance
usn-0.1.0.tar.gz 102.3 kB With provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for USN 0.1.0
File Interpreter ABI Platform
usn-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 214.9 kB

Release files / usn-0.1.0.tar.gz

Download URL usn-0.1.0.tar.gz
Size 102.3 kB
Tags Source
SHA-256 checksum
How to use checksums
e4321dcbeb0b9f3aed6058f988c24b31215c2184390d9ae0974cfacf78769c25
BLAKE2b-256 checksum
How to use checksums
80f509533e77c220764da45cd0c5f4291c788ac0d84da5adf7d49ded5e2e2430
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 28, 2026.

Transparency log

Release files / usn-0.1.0-py3-none-any.whl

Download URL usn-0.1.0-py3-none-any.whl
Size 112.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a9809880623ec30515fadc2552c92afb25726ee623460c0313f6d48e9c877cd3
BLAKE2b-256 checksum
How to use checksums
95b0bfe6e39d6e9894b8a2cd4862f809a43bdad4bf310360770044a10935dd93
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 28, 2026.

Transparency log

Security for USN 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for usn-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Jul 28, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page