Skip to content

Spurline

Spurline logo

A local-first relay for individuals and communities.

Spurline is a lightweight Python Nostr relay built for local continuity and control. It works with the broader relay network and the local mesh without needing to duplicate all of it.

Why Spurline? Get started

Local relay infrastructure

Spurline gives a person, organization, application, or community a local relay that can preserve the events that matter nearby. Public relays remain the mainline. Spurline is the spur: connected to the larger network, but useful in its own local place.

Local first

Run a Nostr relay on your own machine, inside a local application stack, or eventually as part of an appliance.

Selective

A spur line carries the traffic that matters for its destination. Spurline is designed around local relevance rather than whole-network duplication.

Durable

Events are validated, stored in SQLite, replayed to matching subscriptions, and served through a FastAPI runtime.

Part of the Mainstay product family

Spurline is an independently useful sibling in the Mainstay product family. Acorn safeguards user-controlled keys, funds, and records. Safebox Web provides the current human workflow surface. Grove stores opaque encrypted blobs. Spurline provides local event availability and selective synchronization.

Safebox Web -> Acorn -> Spurline
                      -> Grove

Good boundaries, not barriers. Spurline remains a relay rather than becoming the wallet, blob store, mint, or application. Standard Nostr events let it cooperate with those components without making any one deployment permanent.

Spurline is independent enough to run on its own, but shaped to support Mainstay and the future Lockbox appliance profile alongside Acorn, Safebox Web, Grove, and optional Clear currencies.

Read the rationale Review the relay API