Getting started

Choose the API that speaks your language.

The protocols are shared; the installation, lifecycle, and idioms are not. Start with the implementation you will use, then build a small PAIR application you can run locally.

Pick an implementation

These guides are maintained here so the first example tracks each implementation’s current API.

Modern C

NNG

For new C applications. Its modern API, asynchronous foundation, and active development make it the default choice for C.

Start with NNG

Pure Go

mangos

A native Go implementation of the protocols. Use mangos v3 when you want Go’s idioms without a C dependency.

Start with mangos

Legacy C API

libnanomsg

The original C implementation and API. Choose it for existing applications and bindings that depend on libnanomsg.

Start with libnanomsg

Preferred Rust binding

nng-rs

A safe, idiomatic Rust wrapper for NNG. It is independently maintained, with its own release lifecycle.

Start with nng-rs

Preferred Python binding

pynng

Python bindings for NNG with synchronous, asyncio, and Trio-friendly APIs. It is independently maintained.

Start with pynng

Community bindings

Other language bindings

Browse community-maintained bindings and wrappers for C++, Java, JavaScript, Lua, Ruby, and more.

Browse language bindings

The same patterns, different APIs

The featured implementations use the Scalability Protocols. Once your two peers can exchange a message, choose the pattern that matches the shape of your system.