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.3.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.3-py3-none-any.whl (430.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: nustack_py-0.1.3.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.3.tar.gz
Algorithm Hash digest
SHA256 8513ea2b9135c53d5a93c284706067e5d769fc7451bd6c8165fe8eac74cdc7e7
MD5 5f5572d7654bcb5fba236b264529e473
BLAKE2b-256 e9916fde391e5268641c356a27ccf75e8ce477433aac44ed2102e64cfd0f8944

See more details on using hashes here.

Provenance

The following attestation bundles were made for nustack_py-0.1.3.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.3-py3-none-any.whl.

File metadata

  • Download URL: nustack_py-0.1.3-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.3-py3-none-any.whl
Algorithm Hash digest
SHA256 9c116fcac2fbc5bbfe80da99093eb18b4f3c7261aa30a3f448f1cfc1e78ce743
MD5 2267f3179c7a6ba9f5c57b3286fdaed1
BLAKE2b-256 84b7b51fc3b6f80d50ce1941bafb2aa232bc7fb16eb3e13b1b2fb0fd96e9975d

See more details on using hashes here.

Provenance

The following attestation bundles were made for nustack_py-0.1.3-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