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.3.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.3.0
File Size Uploaded Provenance
usn-0.3.0.tar.gz 102.9 kB With provenance Details

Built distribution (wheel)

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

Total release size: 216.0 kB

Release files / usn-0.3.0.tar.gz

Download URL usn-0.3.0.tar.gz
Size 102.9 kB
Tags Source
SHA-256 checksum
How to use checksums
889abca36623b63963caaa43de3dfa28251b15405c8a8f10a537b86b8ca3f592
BLAKE2b-256 checksum
How to use checksums
861842c1b237c3018b814ef26814429c1431749d0549dd46ebb6f69e4fb6b892
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.3.0-py3-none-any.whl

Download URL usn-0.3.0-py3-none-any.whl
Size 113.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8bf7099d278c9d91dd67bb8dea4dcb12764258ffcc673a07c402c3b757115ee9
BLAKE2b-256 checksum
How to use checksums
361e579edca31bb9dbca7e6d5b18a8cf125f5a7d7a662a9c1d4ab796d84dbf25
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.3.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.3.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