MoE Libris

Federated Knowledge Exchange Hub for MoE Sovereign instances.

Latin liber = free & book.

Sovereign AI instances can push knowledge to a Libris hub, which audits and queues it for human review before approved triples become available for federated pull. Inspired by Fediverse architecture — voluntary participation, bilateral trust, no forced assimilation.

---

Quick Start

cp .env.example .env
# Edit: POSTGRES_PASSWORD, NEO4J_PASSWORD, LIBRIS_NODE_ID, LIBRIS_ADMIN_KEY

docker compose up -d

# API:  http://localhost:8080
# Docs: http://localhost:8080/docs  (interactive OpenAPI)

Architecture

graph LR
    A["MoE Sovereign A"] -->|push| Hub["MoE Libris Hub"]
    B["MoE Sovereign B"] -->|push| Hub
    Hub -->|pull| A
    Hub -->|pull| B

    subgraph Hub["MoE Libris Hub"]
        PA["Pre-Audit"] --> AQ["Audit Queue"] --> GG["Global Graph"]
    end

Loading

Security model: Knowledge bundles are transmitted over mTLS (encrypted in transit). There is no end-to-end encryption — the Hub's Pre-Audit pipeline inspects the JSON-LD payload content, and a human Admin reviews bundles in the Audit Queue before graph merge. Privacy protection is handled at the sender node via the Privacy Scrubber before the bundle ever leaves the originating instance.

Stack

FastAPI · PostgreSQL · Neo4j · Valkey · Docker

Tests

pytest tests/   # 43 tests: security, pre-audit, abuse prevention

---

Documentation

Full documentation at docs.moe-sovereign.org/federation:

• Setup Guide — Configure a MoE Sovereign instance as a federation node
• Protocol — Handshake, push/pull, JSON-LD bundle format, hub-to-hub topology
• Trust & Security — Pre-audit pipeline, abuse prevention, trust floor, contradiction detection
• Server Discovery — Public Git registry (moe-libris-registry)

Links

• Main Project — github.com/h3rb3rn/moe-sovereign
• Project Website — moe-libris.org
• Server Registry — moe-libris-registry

License

Apache License 2.0