DocsBlogSpecAbout
fabric ·nustd.mem

Hot state, zero backend.

The simplest state in Nu. Declare a Shape, hang typed Refs, use them. Gone when the process ends.

Read the referenceSee the code

See it.

Declare a Shape, hang typed Refs, use them. That is the whole surface.

The simplest state in Nu.

Same IntRef, DictRef, ShapeRef you use everywhere else in Nu. Reads and writes are in-process, no serialization, no round trip. Use it for cache, hot state, and coordination between Shapes in one process.

No backend to pick. No transactions to wrap. Restart clears it. That is the whole point.

memory.py
python · 26 locpy
import nu
import nustd
class Session(nu.Shape):
user: nustd.mem.StrRef
hits: nustd.mem.IntRef
tags: nustd.mem.PrimitiveListRef[str]
class Cache(nu.Shape):
sessions: nustd.mem.ShapesDictRef[str, Session]
active: nustd.mem.IntRef
# refs read and write like plain attributes
who = Cache.sessions["ada"].user
score = Cache.sessions["ada"].hits + 1
# compose writes as one flow
bump = (
Cache.sessions["ada"].hits.inc()
| Cache.sessions["ada"].tags.append("seen")
| Cache.active.inc()
)
# assemble and run
ctx = nu.Context().bind(dict, {}, Cache)
nu.run(bump, ctx=ctx)

Pick by lifetime.

nustd.mem and nustd.kv share the same Ref shapes. Pick by what the state needs to survive.

nustd.mem

Ephemeral, in-process.

Caches. Live counters. UI state. Anything you can rebuild on restart. Zero setup, zero disk.

nustd.kv

Durable, across restarts.

Users. Orders. Anything you need after a crash. Same Refs, backed by RocksDB or LMDB. Move it to nustd.kv when the state needs to survive a restart.

Combines well with.

Fabrics compose. Wire nustd.mem to a browser, a KV store, or another process without changing your Refs.

nustd.kv

Durable on disk.

Move hot state to disk when you outgrow the process.

nustd.ui

Live browser widgets.

Bind mem state straight into browser widgets. Live updates, no glue.

nustd.proxy

Fabrics on the wire.

Serve a mem fabric over a socket. Another process reads the same Refs.

Try Nu.

One command gets you the wheel with every fabric. Then follow the movies tutorial to build a real app in an afternoon.

01 Install

pip install "nustack-py[all]"

02 Run the demo

nu demo movies

03 Build your app

Browse examples

Like what you see?

The project is young. Star it, join the room, watch what we ship next.

Star on GitHubnustackdev/nuJoin DiscordTalk to the team, share what you build.Follow updatesShip notes and small demos on X.