image

Nu – the interaction primitive.

Build apps in one primitive that spans your whole stack (databases, UIs, AI agents, and services). No glue. 50x less code.

Every app is a set of interactions between systems: a database, a UI, AI agents, and services. Nu makes interaction the primitive:

  • Ref names what you touch. A KV slot, a UI widget, an LLM endpoint, a memory slot, a remote object.
  • Interaction describes what to do with it. Read, write, branch, iterate, compose.
  • Fabric binds Refs to a real backend. Swap the Fabric, keep the tree.

Persistence, reactivity, atomicity, observability, and scalability are inherent, not bolted on.

Example

A dashboard on a live counter that persists across restarts. One Nu tree, two Fabrics.

import nu


class Counter(nu.Shape):
    value: nu.v.IntRef


class Dashboard(nu.ui.Page):
    count: nu.ui.TextRef


class App(nu.ui.Index):
    pages = nu.ui.Pages({"/": Dashboard})


app = nu.With(
    nu.v.presets.rocksdb_navigator(".dbtest"),
    nu.ui.presets.server(
        nu.v.auto_flow_atomic(
            nu.ReactForever(
                Counter.value.on_change(),
                Dashboard.count.set(Counter.value),
            ),
        ),
    ),
    body=(
        nu.IfDo(Counter.value.missing(), Counter.value.set(0))
        >> nu.ForeverDo(
            Counter.value.inc() >> nu.Delay(1.0),
        )
    ),
)


if __name__ == "__main__":
    import asyncio

    asyncio.run(nu.arun(nu.v.auto_flow_atomic(app)))

Run it, open the browser tab. The counter ticks once a second, the dashboard mirrors it live. Kill it, run again, it picks up where it left off.

More examples in examples/. Full walkthrough at nustack.dev/docs.

Fabrics

A Fabric implements Refs against one backend. Nu ships five in-tree.

Fabric What
nu.m In-process substrate. Zero-config default for tests, notebooks, cache.
nu.v Persistent substrate backed by virtuals. Virtual Python collections over RocksDB, LMDB, more.
nu.ui Refs on screen. Binds Nu Refs to a live browser tab.
nu.invisibles Location-independent Nus. Transparent RPC across processes and machines.
nu.ray Compute across the cluster. Scale Nu on Ray without leaving the model.

Swap the Fabric, keep the tree. Same program runs against different substrates.

Install

Python 3.12+.

pip install "nustack-py[all]"

See nustack.dev/docs/how-to/install for lean installs and source builds.

Apps built on Nu

  • nulog. Structured logging as a Nu app. Handles billions of entries, UI dashboard out of the box.

Status

Alpha. APIs will break.

License

Apache-2.0

Project links

Data verified by PyPI on
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.1.6)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for gor_ar from gravatar.com gor_ar

Credits

Author: Gor Arakelyan

GitHub Statistics

Data verified by PyPI on 
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

Apache-2.0
View SPDX License List

Requires

Python >=3.10

Provides Extra

all default distributed infra mem nudle virtuals

Tags

graph programming shape table term topology tree

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nustack_py-0.1.4.tar.gz (1.7 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nustack_py-0.1.4-py3-none-any.whl (430.2 kB view details)

Uploaded Python 3

File details

Details for the file nustack_py-0.1.4.tar.gz.

File metadata

  • Download URL: nustack_py-0.1.4.tar.gz
  • Upload date:
  • Size: 1.7 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for nustack_py-0.1.4.tar.gz
Algorithm Hash digest
SHA256 ffae7fe860ab17ed5f41ee929067d19d2a8aa876304a694f7db6133dd5a28e30
MD5 cd6502421f5274b71c5d450f07c02b8d
BLAKE2b-256 51607d64def42202a31e72c87f952764f729623ca9464ed84b6d83e8f6a62fc0

See more details on using hashes here.

Provenance

The following attestation bundles were made for nustack_py-0.1.4.tar.gz:

Publisher: publish-nu.yml on nustackdev/nu

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file nustack_py-0.1.4-py3-none-any.whl.

File metadata

  • Download URL: nustack_py-0.1.4-py3-none-any.whl
  • Upload date:
  • Size: 430.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for nustack_py-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 2afa1060b17ae3065664b22d329228c9021e9364b231719f0e0ea7baba371295
MD5 892a07e2d522c1d5689bc5d7228fa651
BLAKE2b-256 ad7da9f9a7752410895c7449b39e520462142b8635fa594a7cec8ae927404d97

See more details on using hashes here.

Provenance

The following attestation bundles were made for nustack_py-0.1.4-py3-none-any.whl:

Publisher: publish-nu.yml on nustackdev/nu

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page