About MONAD

MONAD is a compiled identity kernel, a single Rust binary that can be interviewed by AI agents, runs anywhere from a single executable, and remembers its visitors on their own machine without relying on a server. It is compiled, not served, and requires no database or backend, only a kernel and its embedded vault.

The browser interface is an adapter over the kernel, not just a terminal theme. The same core functionality is accessible via the command-line interface (CLI) using npx keshavashiya, within WASM runtimes like wasmtime, and as an MCP server for AI agents.

MONAD embodies a local-first, memory-first philosophy, similar to projects like brain, docify, and codesage. It is free, open-source, and can run on any static host.

Key Features:

• Compiled Identity Kernel: A single Rust/WASM binary for identity management.

• AI Agent Integration: Designed to be interviewed by AI agents via the Model Context Protocol (MCP).

• Local-First & Serverless: Data is stored on the user's machine, never on a server.

• Cross-Platform: Runs on CLI, in WASM runtimes, and as an HTTP service.

• Verifiable Identity: Embeds reproducible SHA-256 hashes for identity verification.

• Extensible Vault: Uses a JSON-based vault for identity data, with a forkable schema.

• Multiple Adapters: Supports web (console), CLI, WASI, and optional HTTP daemon.

Quick Start

To get started, ensure you have Rust and Node.js (v20.19+) installed. Run make setup to install all prerequisites, then make dev to start the development server or make build for a static build.

Project Structure

The project is organized into several key components:

• kernel/: The core Rust logic, host-agnostic.

• firmware/: WASM-bindgen shim for browser adapter.

• console/: Web serial adapter using Vite and TypeScript.

• cli/: Native and WASI binary, MCP server, and npx launcher.

• vault/: Embedded identity data in JSON format.

• daemon/: Optional HTTP server that runs over the kernel.

• lib/: Shared cross-crate data structures.

• scripts/: Build and development tooling.

• docs/: Documentation for the vault-schema protocol.

Deployment & CI/CD

MONAD can be deployed to static hosting platforms. GitHub Actions are configured for CI/CD, automating testing, building, and deployment to GitHub Pages and npm.