NPS

Get Started

English 中文版

NPS is a multi-layer protocol suite. Where you start depends on what you’re building.

The latest suite release is 1.0.0-alpha.18, published 2026-08-15. Install commands and SDK notes remain aligned with that release. The specification tree contains the reviewed, unreleased alpha.19 candidate; package-manager availability is tracked per ecosystem.


I’m writing an AI agent or model client

You need an SDK. Pick your language and follow the quickstart on the Wiki.

Language Install Wiki quickstart
Python pip install nps-lib==1.0.0a18 SDK-Python
TypeScript npm install @labacacia/nps-sdk@1.0.0-alpha.18 SDK-TypeScript
Rust cargo add nps-sdk@=1.0.0-alpha.18 SDK-Rust
Go go get github.com/labacacia/NPS-sdk-go@v1.0.0-alpha.18 SDK-Go
Java implementation("com.labacacia.nps:nps-java:1.0.0-alpha.18") SDK-Java
.NET dotnet add package LabAcacia.NPS.Core --version 1.0.0-alpha.18 SDK-dotnet

Python note: PyPI normalizes the pre-release suffix, so the suite’s 1.0.0-alpha.18 is published as 1.0.0a18.

npm note: pin the explicit version, or use the alpha dist-tag — both resolve to 1.0.0-alpha.18. The unqualified latest dist-tag is deliberately still 1.0.0-alpha.7, so npm install @labacacia/nps-sdk with no version or tag will not give you the current release.


I’m deploying an NPS node or infrastructure

You need the NPS Daemons bundle (npsd + nps-runner + nps-ingress + nps-registry).

nps-ingress is a process-level Internet ingress daemon name, not the retired NWP Gateway Node logical role. CR-0001 replaced that logical role with Anchor Node and Bridge Node.

→ Wiki: Operators-QuickStart


I’m building a protocol integration or bridge

Read the protocol specs (linked from Protocols), then pick a compat adapter:

→ Wiki: Protocol-Designer-Guide


I want to understand NPS before writing any code

Start with Overview (5 min read), then Protocols for the five-layer architecture.


I want to contribute to NPS

See CONTRIBUTING for the process, and Wiki: Contributors-Guide for conventions.


📖 For tutorials, references, and operator guides, see the NPS handbook.