Skip to content

v0.1.0 — Type system for the Mensch ↔ Maschine interface

Choose a tag to compare

@porco-rs porco-rs released this 12 Feb 15:32
· 27 commits to main since this release

v0.1.0 — Type system for the Mensch ↔ Maschine interface

Everywhere AI touches data, a contract is missing. GERMANIC is that contract.

cargo install germanic


What is GERMANIC?

A schema-validated binary compiler for AI agents. JSON in, validated .grm binary out. If the data is incomplete, it won't compile.

Built in Rust. Zero-copy FlatBuffers. No runtime dependencies.

Highlights

Schema-Validated Compilation

  • JSON → schema validation → FlatBuffer → .grm binary
  • Required fields, type checking, nested validation, empty string detection
  • All errors collected at once — not just the first

No Rust Knowledge Required

  • germanic init --from example.json infers a schema from any JSON
  • germanic compile --schema my.schema.json --input data.json compiles it
  • Edit the .schema.json to mark required fields — that's it

JSON Schema Draft 7 Compatible

  • Accepts both GERMANIC .schema.json and standard JSON Schema Draft 7
  • Auto-detection — no flags needed

MCP Server

  • 6 tools: compile, validate, inspect, schemas, init, convert
  • Built on rmcp 0.8, stdio transport
  • Behind mcp feature flag: cargo install germanic --features mcp

42 Domain Schemas

  • Healthcare, dining, trades, education, real estate, legal, public services, mobility, business, associations, agriculture
  • German + English translations
  • All with fictional example data

Contract Proof

  • 10 test scenarios proving what GERMANIC catches vs HTML/JSON-LD/JSON Schema
  • Run it yourself: cargo test --test vertragsbeweis -- --nocapture

Install

cargo install germanic

Quick Start

echo '{"name": "Dr. Sonnenschein", "phone": "+49 30 1234567"}' > practice.json
germanic init --from practice.json --schema-id health.practice.v1
germanic compile --schema practice.schema.json --input practice.json --output practice.grm
germanic inspect practice.grm

Links

Technical Details

  • Rust Edition: 2024
  • MSRV: 1.85
  • License: MIT OR Apache-2.0
  • Tests: 101 (without MCP) / 109 (with MCP)
  • Dependencies: Zero external runtime deps for core functionality
  • flatc: Not required — FlatBuffer bindings are pre-generated