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.2.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.2.0
File Size Uploaded Provenance
usn-0.2.0.tar.gz 102.9 kB With provenance Details

Built distribution (wheel)

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

Total release size: 216.0 kB

Release files / usn-0.2.0.tar.gz

Download URL usn-0.2.0.tar.gz
Size 102.9 kB
Tags Source
SHA-256 checksum
How to use checksums
021af068efb89400bd6cf6ac1ebf4a26553f2669f294a0d90f14c6acdb5938bd
BLAKE2b-256 checksum
How to use checksums
0eb333ad8cd5f7891ef5b5a807150eae5c58fe9f97026f2ad287f2b187a13d8f
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.2.0-py3-none-any.whl

Download URL usn-0.2.0-py3-none-any.whl
Size 113.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0bf7c6aa65833c72fdb92cc9486db3ad3e04c134fc9ca71b39f1da215ec67a6d
BLAKE2b-256 checksum
How to use checksums
5d1f1c1f106dd94d3d90a4742b32da31c9cc6f455e8314deeb26ededf9708967
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.2.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.2.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