Install the tools

The commands below assume both checkouts sit next to your projects:

work/
├── ndsr/          # runtime
├── necter-sdk/    # hivekit-rs, hivekit-go, hivekit-js, hivekit (Python), hivejs
└── my_module/     # your code

NDSR

Requires a stable Rust toolchain (1.85 or newer). No system protoc is needed.

cd ndsr
cargo build --release --bin ndsr
install -m 755 target/release/ndsr ~/.local/bin/ndsr     # or anywhere on your PATH
ndsr --version                                           # ndsr 1.0.0

Every hivec finds ndsr through $NDSR_BIN, then ndsr on your PATH, then a tools/ndsr in any parent directory.

HiveKit

rustup target add wasm32-unknown-unknown
cargo install --path necter-sdk/hivekit-rs        # installs `hivec` into ~/.cargo/bin

In your module’s Cargo.toml:

[dependencies]
hivekit = { path = "../necter-sdk/hivekit-rs" }

Go 1.21+ and TinyGo (tested with 0.42.0). On macOS: brew tap tinygo-org/tools && brew install tinygo, or unpack a release and point $TINYGO at its bin/tinygo.

cd necter-sdk/hivekit-go
go build -o ~/.local/bin/hivec ./cmd/hivec

In your module’s go.mod:

require github.com/necter-network/hivekit-go v0.0.0

replace github.com/necter-network/hivekit-go => ../necter-sdk/hivekit-go

Node.js 18+. The AssemblyScript compiler (0.28.20) is bundled.

cd necter-sdk/hivekit-js
npm ci && npm run build
npm install -g .

Node.js 18+. The prebuilt JavaScript engine runtime ships in the package; no Rust toolchain is needed.

cd necter-sdk/hivekit-js
npm ci && npm run build
npm install -g .

Python 3.8+. Depends only on click and pycryptodome; the prebuilt Python runtime ships in the package.

python3 -m venv .venv && . .venv/bin/activate
pip install ./necter-sdk/hivekit

Each SDK installs a command named hivec. If you use several languages, install them into separate environments or rename the binaries (for example hivec-go).

Calling modules from apps

hivejs (in necter-sdk/hivejs) is a dependency-free client for browsers and Node. Build it with npm ci && npm run build and add it to your app as a local dependency:

{ "dependencies": { "hivejs": "file:../necter-sdk/hivejs" } }

Usage: Upload and call a module.

Check your setup

ndsr --version
hivec --help

Then follow the quickstart.