documentation

Metnos

by Roberto Brunialti
The guide to using Metnos and understanding its architecture.
μῆτις + νοῦς — mêtis (the mind that adapts) + noûs (the mind that reasons): the two Greek words for mind, joined into one name. · technical project name: metnos

The navigation column on the left arranges every page by subject. If you prefer to start with a concrete task, choose one of the three doors below; to look up a term or component, search the tree.

Quick tour 20 min · PDF available Understand the architecture visual guide Consult the code repository and note

Metnos is an agent governor designed to run on a local computer: it governs agents whose operational scope is defined explicitly. The reference configuration acts as a personal and household assistant, but that is only one possible form, determined by the admitted executor catalog. With a different catalog, Metnos can support software maintenance, research, remote-system management, or another well-bounded operational domain. The core plans, judges, remembers, and records; executors determine what the system can actually do. What distinguishes Metnos, therefore, is not only its code but the structure of definitions that precedes and governs execution: which powers are granted, within which limits they may be exercised, and in what vocabulary the system communicates with the person who remains in control.

How this guide is arranged

The documentation describes the current product: an introductory guide, the interface map, a domain reference with natural-language examples, the components administered under System, and the Architecture guide with technical contracts. The tree on the left follows a teaching path: use first, then core concepts, the observable system, execution architecture, reasoning, operations, and finally further reading. Technical catalogs and the interface page are generated from runtime registries; the Tutor compiles these sources together with admitted manifests into a signed catalog. The public repository contains the code and installer needed to verify the documented contracts.

Dialogues

The dialogues are the thought behind Metnos put under the pressure of objection: not treatises, not specifications, but ideas made to answer an uncomfortable peer. The form is Galilean — two voices, both the author’s, one of which refuses to grant easy agreement. Not fiction: only the structure is dialogic, the content is real.

The whole corpus

For anyone
Quick tour & Survival kit — Metnos in 15–20 minutes Nine real scenes, including the cross-domain Atlas dossier, and a dedicated Tutor chapter: how Metnos explains capabilities and procedures, observes admitted instance state, and hands a possible action to the normal engine only after confirmation. The guide also covers interface, consent, memory, growth, devices, limits, and a glossary. An accessible HTML version is also available.
HTML · 20 min
Domain reference — what to ask Metnos All 27 canonical domains explained one by one, with boundaries, availability, and natural-language request examples. Technical names and counts derive from manifests and builtin contracts.
Reference · 15 min
Opening and using Metnos — first access, first operations Which address opens the web chat, how to get in the first time, what you do in the conversation, and the exact steps to create a new user and give them access.
Guide · 6 min
The interface — two channels, one identity How the interface is arranged: the two channels and their separate conversations, the four Settings sections, and the map of administration pages with their navigation paths. The map derives from the runtime’s surfaces registry.
Guide · 8 min
System — components and controls A practical guide to models, services, LRE (Long Run Engine), safety, users, and devices, with real HTTP UI captures and operating guidance.
Section · 25 min
Foundations
Architecture guide One visual tutorial from the system's purpose and request flow to executor authority and the exact contracts of every component. Inline SVG diagrams, printable as PDF.
20 min
Tutor — Metnos can explain Metnos The local component that compiles admitted manifests, runtime registries, and published documentation into a signed catalog. It separates explanations from actions, applies access control before composition, and answers with no tools.
8 min
Multilingual by definition How the instance language travels through a Metnos request: execution context, prompts, manifests, i18n messages, Tutor, the fallback chain, and planned full self-localisation.
Guide · 10 min
Vision and assessment
Perspectives and judgement A critical assessment of the architecture from several viewpoints: usefulness, autonomy, proactivity, anthropomorphism risks, and conditions for governance.
Analysis · 20 min
Extended perspectives Capabilities that broaden Metnos's reach and the architectural conditions required to introduce them without confusing a possibility, a design, and an available function.
Analysis · 20 min
Dialogues
Dialogue on ends and limits Four Giornate on proactivity, laws, ends, judgement, and the separation between deterministic guard and graduated evaluation.
Reflection · 25 min
Dialogue on executors and distributed memory Four Giornate on executor contracts and forms of operational memory: mnests, traces, the mnestome, decay, and composition.
Reflection · 25 min
Reference
Glossary Technical and conceptual terms used throughout the corpus, with links to the pages that define their current contract.
Reference
Component contracts

The Architecture guide includes the complete component atlas. From there, each component name opens its canonical implementation contract: schemas, calls, authority, failure conditions and conformance checks.

Code
Public repository Code, installer, and English technical documentation under the AGPL-3.0 license. The code note explains the relationship between the public repository and an installed instance.
GitHub