QJSON Agents / YSON ● research
a local-first agent runtime — and its own file format
QJSON Agents is my answer to "agentic AI" that turns out to be a cloud wrapper. Everything runs locally and everything is inspectable: an agent is just a persona manifest plus its memory, both stored as files you can open and edit. Its behavior is determined by what you can read, not by a black box.
Memory is layered. A chronological memory.jsonl logs every turn; an event log records forks and swaps; a Fractal Memory store holds structured knowledge; and a retrieval layer with a FAISS-style IVF index does fast semantic recall. Agents can be forked, mutated, and composed into swarms and clusters with real communication topologies.
Personas are written in YSON — a custom configuration format I built because JSON was too noisy for hand-authoring agent identities. The same memory stack later became a drop-in plugin for other agent frameworks.
// highlights
- Local-first: personas + memory are plain, inspectable files
- Layered memory: JSONL log + event log + FMM + RAG retrieval
- FAISS-style IVF index for fast semantic recall
- Fork / mutate / swarm — multi-agent topologies
- YSON — a hand-authorable persona format of my own design
// stack
- Python
- Ollama
- SQLite
- FAISS
- YSON