libertaria-stack/janus-sdk
Markus Maiwald ccf521131a
feat(janus-sdk): add libertaria sdk v0.1.0-alpha
Add Janus language SDK for Libertaria with core modules:

- identity: cryptographic agent identity with rotation/burn

- message: signed, content-addressed messages

- context: NCP implementation

- memory: LanceDB vector store integration

- lib: unified API exports
2026-02-03 08:09:43 +01:00
..
libertaria feat(janus-sdk): add libertaria sdk v0.1.0-alpha 2026-02-03 08:09:43 +01:00
README.md feat(janus-sdk): add libertaria sdk v0.1.0-alpha 2026-02-03 08:09:43 +01:00

README.md

Libertaria SDK for Janus

Sovereign; Kinetic; Anti-Fragile.

The Libertaria SDK provides primitives for building sovereign agent networks on top of Janus.

Status: v0.1.0-alpha (2026-02-03)

Core Modules

Module File Status Purpose
identity identity.jan Draft Cryptographic agent identity with rotation/burn
message message.jan Draft Signed, content-addressed messages
context context.jan Draft NCP (Nexus Context Protocol) implementation
memory memory.jan Draft Vector-backed semantic memory (LanceDB)
lib lib.jan Draft Unified API export

Quick Start

import libertaria

-- Create sovereign agent
let agent = libertaria.create_sovereign_agent()

-- Create identity with rotation capability
let (new_id, old_id) = identity.rotate(agent.identity)

-- Send signed message
let msg = message.create(
  from = agent.identity,
  content_type = Text,
  content = bytes.from_string("Hello Sovereigns!")
)

-- Create hierarchical context
let ctx = context.create({})
let sub_ctx = context.fork(ctx, reason = "Sub-conversation")?

-- Store in semantic memory
let emb = memory.embed(message.content(msg))
let vs = memory.store(agent.memory, message.id(msg), emb, "...")

Design Principles

  1. Exit is Voice — Agents can leave, taking their data cryptographically (identity.burn)
  2. Profit = Honesty — Economic stakes align incentives (staking module planned)
  3. Code is Law — No central moderation, only protocol rules
  4. Binary APIs — gRPC/MsgPack/QUIC over REST

Architecture

┌─────────────────────────────────────────────┐
│           Libertaria SDK                     │
├──────────┬──────────┬──────────┬────────────┤
│ Identity │ Message  │ Context  │ Memory     │
│          │          │ (NCP)    │ (LanceDB)  │
├──────────┴──────────┴──────────┴────────────┤
│              Janus Standard Library          │
├─────────────────────────────────────────────┤
│           Janus Compiler (:service)          │
└─────────────────────────────────────────────┘

Next Steps

  • Staking/Economics module (spam prevention)
  • Channel module (QUIC transport)
  • Discovery module (DHT-based agent lookup)
  • Governance module (voting, proposals)
  • Test suite
  • Integration with Janus compiler

License

MIT + Libertaria Commons Clause

Forge burns bright. The Exit is being built.