PROTOCOL V0.33 STABLE

K-ATOMS
The Atomic Unit of Knowledge

K-ATOM is the Docker for knowledge โ€” self-contained, reproducible, and portable as an image. A Content-Addressed Knowledge system designed for the era of Human-AI collaboration: an atomic unit of knowledge packaged as a standard image that is simultaneously human-readable, machine-executable, and cryptographically verifiable.

One self-contained object carries full context: data, code, provenance, and identity. Zero infrastructure. Total portability. Built for agents, scientists, pipelines, and the field.

K-Atom Demo
๐Ÿ“„

The Human World

Documents, PDFs, Markdown. Visual and contextual, but "lossy" and hard for machines to parse effectively.

๐Ÿ’พ

The Machine World

Databases, APIs, Vectors. Structured and operational, but invisible, abstract, and fragile to humans.

โš›๏ธ

The K-ATOM

The unified primitive. A portable image humans can share, containing a structured DB that agents can read.

The Foundry

Client-side artifact generator & inspector. No server required.

LOCAL

DROP FILE TO SMELT

.MD / .JSON / .CSV / .PDF

8 Ways to Use K-Atoms

01 Agent Memory

Snapshot an agent's entire context window, rules, and intermediate state into a single image. Load it later to resume execution perfectly.

02 Reproducible Science

A single K-Atom containing the PDF paper, the CSV dataset, and the Python analysis script. One file, total reproducibility.

03 Visual GitHub

Commits you can see. If the code changes, the fractal changes. A grid of K-Atoms becomes a visual history of project evolution.

04 AI Pipelines

Agent A outputs a K-Atom. Agent B ingests it. The pipeline isn't a hidden JSON stream; it's a gallery of inspectable artifacts.

05 Offline Field Ops

Distribute critical manuals and databases via AirDrop or Bluetooth as images. Zero infrastructure required.

06 Graph Nodes (RAG)

Store the K-Atom as the visual node in a GraphDB. Use the payload to generate vector embeddings. The perfect RAG primitive.

07 Verified Publishing

Using Ed25519 signatures, authors can cryptographically sign their research. The Viewer verifies provenance instantly.

08 Physical Interaction

Print the K-Atom. A mobile agent scans the core, verifies the hash, and downloads the payload. The paper becomes the database.

Get Started

K-ATOM is a zero-dependency primitive. It runs everywhere.

1. For Humans (Zero Setup)

Clone the repo and open index.html. That's it. No build step, no npm install, no servers.

git clone https://github.com/reginaldoandrade/katoms.git cd katoms open index.html

2. For Agents (Library Mode)

Copy app.js (renaming to katom.js) into your agent's tools folder. Use it to read/write atoms programmatically.

// Example: Agent reading a K-Atom import { KAtom } from './katom.js'; // hypothetical wrapper const atom = await KAtom.load('memory-snapshot.svgz'); const context = atom.read('agent/context.json'); console.log("Restoring state:", context.last_thought);