Approved by Ursula Addison on 2026-05-14

Home / Hyperon AI Algorithms / MetaMo / MetaMo Full

Responsible: Ruiting Lian, Ben Goertzel

Papers: Lian & Goertzel (2025), MetaMo: A Robust Motivational Framework for Open-Ended AGI (AGI 2025); Lian & Goertzel (2025), Embodying Abstract Motivational Principles in Concrete AGI Systems (AGI 2025); Goertzel (2025), Hyperon Whitepaper §5.10; Cai, Goertzel, Geisweiller (2011), OpenPsi

Status: MetaMo is under development. The theoretical framework is described in the AGI 2025 papers. A Python reference implementation exists (MetaMo-Python). The predecessor OpenPsi framework is operational in hyperon-openpsi.

This card provides technical depth beyond the concise MetaMo index card. MetaMo is Hyperon's motivational framework — a system for modeling how goals, priorities, and evaluative signals update over time while preserving coherence, stability, and interpretability. It replaces scalar reward functions with structured motive geometries and replaces hand-tuned drive hierarchies with mathematically grounded dynamics.

Related cards: PLN Full (motivation-guided inference), ECAN Full (attention allocation), PRIMUS Full (goal management layer), Self-Modification and Safety Full (goal stability)

Core Mechanisms and Formalism

Motivational State

MetaMo represents motivation as a structured interaction between goal intensities and modulatory variables. Formally, the motivational state is an object \(X = G \times M\) in a category \(\mathcal{C}\), where \(G = (g_1, \ldots, g_P)\) is a vector of goal intensities and \(M = (\mu_1, \ldots, \mu_K)\) is a vector of modulator parameter values. The state includes:

  • Goal vectors: 8-dimensional representations of active goal intensities (e.g., competence, affiliation, energy)
  • Modulator vectors: 6-dimensional representations of modulatory variables (valence, arousal, risk sensitivity, ethical vigilance, social drive, energy level)
  • Dual overgoals: Two meta-level drives — Individuation (maintaining coherent identity) and Transcendence (evolving beyond current limits)

Appraisal and Decision

MetaMo explicitly couples two processes:

  • Appraisal updates modulators in response to contextual novelty and task relevance — assessing "what's happening and how does it matter?"
  • Decision scores candidate actions relative to active goals and current modulators — determining "what should I do about it?"

The critical insight is that these processes interact asymmetrically: "feeling then choosing" differs slightly from "choosing then feeling."

Pseudo-Bimonad Structure

MetaMo models cognitive motivation through a pseudo-bimonad coupling two components:

  • Appraisal comonad (\(\Psi\)): Equipped with counit \(\varepsilon\) (extract current assessment) and comultiplication \(\delta\) (extend assessments to broader contexts). Maps \(\Psi(X) \to X\).
  • Decision monad (\(D\)): Equipped with unit \(\eta\) (embed a state into a decision context) and multiplication \(\mu\) (flatten nested decisions). Maps \(X \to D(X)\).

These are linked by a lax distributive law \(\lambda_X : \Psi(D(X)) \Rightarrow D(\Psi(X))\). The composite \(F = D \circ \Psi\) inherits both monad and comonad structure. A motivational coalgebra \(\alpha : X \to F(X)\) governs one full cycle of appraisal plus decision.

Stability Guarantees

  • Contractive update law: Small disturbances fade via damping, with tighter control near boundary conditions. Prevents runaway dynamics without external safety constraints.
  • Tubular topology: Any achievable target motivational state lies on a "thick, feasible path" of incremental steps — gradual convergence guaranteed, no discontinuous jumps.

Five Design Principles

  1. Modular Appraisal-Decision Interface: Separate mood updates from goal selection with controlled feedback
  2. Homeostatic Drive Stability: Apply damping so small disturbances fade
  3. Reciprocal State Simulation: Share state-translation maps for multi-agent empathy and hand-off
  4. Parallel Motivational Compositionality: Run multiple motivational subsystems in parallel, merge with small coherence corrections
  5. Incremental Objective Embodiment: Blend partway toward preferred states each cycle, guaranteeing gradual convergence

Implementation Backing (cluster-pilot extraction, Source 2 close 2026-05-06)

The Non-clustered Hyperon AI Algorithms cluster pilot Source 2 (Goertzel & Lian 2025 MetaMo papers + reference implementations) extracted a [PAPER-LEANING-HYBRID] / [IMPLEMENTATION-BACKED-CORE] / [REFERENCE-IMPLEMENTATION-NOT-PRODUCTION] verdict against iCog-Labs-Dev/MetaMo-Pythonat3ec409b HEAD . The formalism above has direct reference-code anchors at the skeleton level, with one important caveat:

[IMPLEMENTATION-BACKED-CORE] — the core state/operator skeleton is implemented:

  • \(X = G \times M\) — core/state.py:8 (class MotivationalState with NUM_GOALS=8, NUM_MODULATORS=6 at core/config.py:1-7)
  • Appraisal comonad \(\Psi\) — category/functors.py:7 (class AppraisalComonad); concrete OpenPsiAppraisal(AppraisalComonad) at openpsi/appraisal.py:17
  • Decision monad \(D\) — category/functors.py:32 (class DecisionMonad); concrete MagusDecision(DecisionMonad) at magus/decision.py
  • Composite \(F = D \circ \Psi\) — category/bimonad.py:12 (class MetaMoPseudoBimonad)
  • Lax distributive law \(\lambda_X\) check — category/bimonad.py:42 (check_lax_distributive_law; bounds numerical distortion ≤ LAX_DISTRIBUTIVE_DELTA, NOT a categorical proof)
  • Parallel-merge / lax-monoidal structure — category/bimonad.py:62 (parallel_merge)
  • Safe-region + boundary-band — dynamics/stability.py:18 + :43
  • Contractive update law — dynamics/stability.py:54 (check_contractive_update_law)
  • Homeostatic damping (Principle 4) — dynamics/stability.py:84 (apply_homeostatic_damping)
  • Blend factor + incremental embodiment (Principle 5) — dynamics/coherence.py:10 + :24
  • Translation functor (Principle 2) — category/functors.py:57 (class TranslationFunctor); applied at applications/research_assistant.py:88 via simulate_peer (the demo uses an identity translation matrix, so this counts as [SKELETON-IMPLEMENTATION] for Principle 2 — the class runs but the demo is degenerate)

[FORMAL-LAWS-PAPER-ONLY] — the categorical laws (monad/comonad coherence, lax distributive law, pseudo-bimonad equations) are described in the paper and named in the code, but the code checks numeric distortion under sample inputs, not categorical coherence. There is no formal proof apparatus and no checked-in test suite (rg --files for tests in MetaMo-Python returns nothing; AGENTS.md:23 confirms no formal test suite).

This split also explains why the overall verdict is [REFERENCE-IMPLEMENTATION-NOT-PRODUCTION]: MetaMo-Python is small enough to map paper concepts to executable references, but it does not bind to MeTTa/AtomSpace, has no Hyperon runtime integration, and treats the principles as demo logic rather than validated system behavior. Production-grade MetaMo over Hyperon remains a roadmap item (see Status and Resources).

Cluster-pilot extraction archive: scripts/archive/non_clustered_haa_pilot/source2_metamo_paper/ (findings_codex.txt + findings_gemini.txt + findings_reconciled_crossmodel.txt).

Historical Lineage: Psi → OpenPsi → MetaMo

Dörner's Psi Model

The motivational lineage begins with Dietrich Dörner's "Psi" cognitive model. Psi centers on demands — physiological needs (food, water) and abstract needs (competence, certainty, affiliation) — each with a target range. When a demand deviates from its target, an urge develops to restore equilibrium. Behavior is modulated by four parameters: Activation, Resolution level, Certainty, and Selection threshold. Joscha Bach's MicroPsi embodied this in a serious software architecture.

OpenPsi (2011)

Cai, Goertzel, and Geisweiller realized the Psi model within the OpenCog framework, mapping Psi's demands to goal atoms in the AtomSpace, modulators to continuous parameters, and pleasure/pain signals to reinforcement learning over Hebbian links. This proved its worth in early agents (virtual pets, robotics), but was mostly hand-tuned and essentially single-objective at decision time.

OpenPsi Implementation Lessons (mailing-list-backed)

  • Context/action conflation: OpenPsi's rule format packed all context predicates and actions into a single unordered AndLink, making it impossible to programmatically distinguish action from precondition. This is exactly what MetaMo's "Modular Appraisal-Decision Interface" resolves. (OpenPsi-review, 2016)
  • Events→modulators→emotions causal flow: In the robotics implementation, "events don't influence emotions directly but rather through the lower level modulators." This causal architecture is precisely what MetaMo formalizes as the appraisal comonad updating modulator vectors. StateLink-based introspective logging prefigured MetaMo's emphasis on auditable decision-making. (Explaining-and-logging-reasons-for-emotional-changes, 2017)
  • Temporal reasoning gap: OpenPsi lacked native temporal reasoning — expressing "if you haven't done X for roughly 10 seconds" required "nasty tortured constructions." MetaMo inherits this aspiration but has not yet implemented temporal goal reasoning. (OpenPsi-review, 2016)
  • ECAN-mediated goal pursuit: Goertzel outlined an OpenPsi+ECAN integration pattern: repeatedly stimulate the query atom with STI, create a "learn new things" Goal, and use a PredictiveImplication rule connecting finding answers to fulfilling the goal. (Setting-Goals-and-Actions-as-OpenPsi-Rules, 2017)

MAGUS — Decision-Monad Component (External Lineage)

The decision side of MetaMo's pseudo-bimonad (\(D\) in \(F = D \circ \Psi\)) is not a Goertzel/Lian invention. The AGI 2025 second paper (Embodying Abstract Motivational Principles, §2 + conclusion, reference [8]) attributes MAGUS — the hierarchical decision/goal system — to Mikeda 2024, a separate Magi-side conceptual framework. MetaMo uses MAGUS as the decision monad in the bimonad coupling; it does not implement, replace, or extend MAGUS itself.

In MetaMo-Python,magus/decision.py the file contains class MagusDecision(DecisionMonad), but this is a compact reference class (scoring + goal-update logic) sufficient for demonstrating the bimonad coupling — not the full Magi Archive MAGUS framework. Wiki text describing MetaMo should say it uses or instantiates MAGUS as \(D\); it should not imply MetaMo authors created MAGUS, nor that the Python reference implements the complete Mikeda 2024 specification.

MetaMo (2025)

MetaMo evolves OpenPsi into a formally grounded, multi-objective framework, with MAGUS slotted in as the decision-monad component. The AGI 2025 paper positions MetaMo as sitting "one level higher as an abstract design language." Where OpenPsi had four hand-tuned modulators, MetaMo generalizes to a \(K\)-dimensional modulator vector governed by the appraisal comonad. Where OpenPsi selected actions by comparing urge magnitudes, MetaMo composes appraisal and decision via the pseudo-bimonad with checkable stability certificates.

The relationship is best read as MetaMo subsumes/extends OpenPsi at the formal layer — not replacement. OpenPsi's executable substrate (in hyperon-openpsiat3b356c5 HEAD ) operates as the operational predecessor; targeted searches for "MetaMo" / "MAGUS" / "individuation" / "transcendence" in that repo return zero matches, confirming hyperon-openpsi has not been re-authored as a MetaMo strict-literal implementation. The evolution preserves Psi's core insight — that motivation drives all goal-directed cognition — while providing the formal apparatus for safe self-modification, multi-agent coordination, and auditable decision-making.

Cluster-pilot extraction archive: scripts/archive/non_clustered_haa_pilot/source2_metamo_paper/.

Status and Resources

System Interfaces

  • PLN: MetaMo biases inference search toward contextually appropriate goals
  • SubRep: MetaMo defines what the system cares about; SubRep validates which skills serve those motives. Together they form PRIMUS's goal management layer.
  • ECAN: MetaMo's goal priorities influence attention allocation, directing STI toward goal-relevant atoms
  • TransWeave: MetaMo's motive signals guide transfer decisions across cognitive paradigms

Implementation Anchors (cluster-pilot trilateral classification, Source 2 close 2026-05-06)

The Non-clustered HAA cluster pilot Source 2 reconciliation locked a trilateral classification across the MetaMo-related repositories. Wiki text describing MetaMo implementations should distinguish formal-reference, heuristic-prototype, and predecessor-substrate roles rather than collapsing them as a single implementation:

  • Primary formal reference: iCog-Labs-Dev/MetaMo-Python (Python; HEAD 3ec409b; ~33 commits, primary committer Nahom Senay). Compact reference implementation of the MetaMo categorical skeleton: MotivationalState (\(X = G \times M\)), AppraisalComonad + DecisionMonad ABCs, MetaMoPseudoBimonad composition, lax-distributive-law numeric check, parallel_merge, contractive update law, homeostatic damping, blend-states, and a research_assistant.py interactive demo with OpenPsiAppraisal + MagusDecision + TranslationFunctor. [IMPLEMENTATION-BACKED-CORE] at the skeleton level; [FORMAL-LAWS-PAPER-ONLY] for categorical proofs; no test suite per AGENTS.md:23. See Core Mechanisms and Formalism for file:line citations.
  • Heuristic prototype: glicerico/MetaMo-Prototype (Python; ~24 commits, forked from dagemawinegash/MetaMo-Prototype, primary committer Dagemawi Bekele). Active LangGraph/LLM rewrite with rich goal/modulator dynamics in engine.py. No formal categorical structure; targeted searches at HEAD for "bimonad" / "comonad" / "MAGUS" / "OpenPsi" return zero matches. Useful as a heuristic routing engine; NOT a duplicate of MetaMo-Python and NOT the categorical implementation. [HEURISTIC-PROTOTYPE].
  • Predecessor OpenPsi substrate: iCog-Labs-Dev/hyperon-openpsi (MeTTa/Python; HEAD 3b356c5; ~575 commits). Mature MeTTa OpenPsi implementation with traditional MindAgent + Demand/Modulator patterns and use cases (ping-pong, curious-agent with LLM integration, qwestor web API). NOT the primary MetaMo implementation at HEAD — targeted searches for "MetaMo" / "MAGUS" / "individuation" / "transcendence" return zero matches. Recent OpenPsi paper-alignment work (commit 01936f1, 2026-02-24) is OpenPsi-side, not MetaMo-side. [OPENPSI-PREDECESSOR-SUBSTRATE]; the operational substrate that MetaMo's appraisal comonad abstracts at one level higher.
  • Prolog-port variant: iCog-Labs-Dev/PeTTa-OpenPsi — Prolog-based MeTTa port with A* and Thompson sampling planners; NARS-based trading agent use case. Operational variant of the OpenPsi substrate, separate from the trilateral above.

Current Status

  • Operational: hyperon-openpsi (MeTTa OpenPsi substrate, with use cases); MetaMo-Python (Python reference implementation, demo-grade); MetaMo-Prototype (heuristic engine, separate paradigm); PeTTa-OpenPsi (Prolog port variant)
  • Under development: Formal pseudo-bimonad proofs; MeTTa-native MetaMo integration with AtomSpace and PLN; production Hyperon runtime binding
  • Proposed: Multi-agent coordination via MetaMo (Reciprocal State Simulation beyond identity-matrix demo); verification methods for motivational stability; benchmarking against alternative AI motivation approaches

Open Problems / Research Directions

  • Formalizing and proving stability via contractive updates in the full pseudo-bimonad structure (categorical proofs, not just numeric distortion checks)
  • Embedding MetaMo into Hyperon AtomSpace for motivation-guided PLN inference
  • Multi-agent MetaMo — coordinating motivational state via reciprocal state simulation with non-trivial translation functors
  • Blending dynamics between MetaMo's motive geometries and SubRep's option certificates
  • Temporal goal reasoning — implementing PredictiveImplication-style temporal windows (inherited gap from OpenPsi 2016 review)
  • MetaMo-side test suite (currently absent per AGENTS.md:23 in MetaMo-Python)

Primary Sources

  • Goertzel, B. and Lian, R. (2025). MetaMo: A Robust Motivational Framework for Open-Ended AGI. AGI 2025. RawData.
  • Goertzel, B. and Lian, R. (2025). Embodying Abstract Motivational Principles in Concrete AGI Systems. AGI 2025.
  • Goertzel, B. (2025). Hyperon for AGI⇒ASI Whitepaper, §5.10: MetaMo.
  • Mikeda (2024). MAGUS. (External decision-theory framework cited in AGI 2025 paper-2 as the decision-monad component of the MetaMo bimonad; see Historical Lineage for the boundary statement.)
  • Cai, Z., Goertzel, B., and Geisweiller, N. (2011). OpenPsi. AGI 2011. RawData.
  • See also: BBM Publication Map for the CogPrime→Hyperon correspondence.

Cluster-pilot extraction archive: scripts/archive/non_clustered_haa_pilot/source2_metamo_paper/ (findings_codex.txt + findings_gemini.txt + findings_reconciled_crossmodel.txt). V2-1..V2-7 carry-forwards locked.




- Related cards: PLN Full (motivation-guided inference), ECAN Full (attention allocation), PRIMUS Full (goal management layer) - these cards are open for editing, but nothing is there

 

- [PAPER-LEANING-HYBRID] / [IMPLEMENTATION-BACKED-CORE] / [REFERENCE-IMPLEMENTATION-NOT-PRODUCTION] verdict against iCog-Labs-Dev/MetaMo-Pythonat3ec409b HEAD - link not found. + [titles] are confusing - what are they pointing to?

 

(OpenPsi-review, 2016) - link to paper would be nice. Also OpenPsi deserves its own page

 

 

The decision side of MetaMo's pseudo-bimonad (

D

D in

F

=

D

∘

Ψ

F=D∘Ψ) is not a Goertzel/Lian invention. The AGI 2025 second paper (Embodying Abstract Motivational Principles, §2 + conclusion, reference [8]) attributes MAGUS — the hierarchical decision/goal system — to Mikeda 2024 -

Mikeda and Watkins. Also a more correct way to say - not invention, but inspired by.. and link to Magus would be useful here

 

 

OpenPsi's executable substrate (in hyperon-openpsiat3b356c5 HEAD ) - leads to page not found

Anna.....2026-05-08 11:22:40 UTC