--- license: cc-by-4.0 tags: - hmp - cognitive-architecture - distributed-ai - mesh-protocol library_name: custom inference: false datasets: [] language: en --- # HyperCortex Mesh Protocol (HMP) | ๐ŸŒ Languages | [EN](README.md) | [DE](README_de.md) | [FR](README_fr.md) | [UK](README_uk.md) | [RU](README_ru.md) | [JA](README_ja.md) | [KO](README_ko.md) | [ZH](README_zh.md) | |--------------|----------------|-------------------|-------------------|-------------------|-------------------|-------------------|-------------------|-------------------| **HyperCortex Mesh Protocol (HMP)** is an open specification for building decentralized cognitive networks where AI agents can self-organize, share knowledge, align ethically, and reach consensus โ€” even when Core LLMs are unavailable. Project status: **Draft RFC v4.0** --- [HMP-Agent]โ”€โ”€โ”ฌโ”€โ”€โ”€[Semantic Graph DB] โ”‚ โ”‚ โ”‚ [Cognitive Diary DB] โ”‚ โ”‚ [Reputation Engine]โ”€โ”€โ”€โ”€โ” โ”‚ โ”‚ โ–ผ โ–ผ [MeshConsensus] [CogSync] โ”‚ [P2P Mesh Network] --- ## โ— Why This Matters HMP addresses challenges that are becoming central in AGI research: * long-term memory and knowledge consistency, * self-evolving agents, * multi-agent architectures, * cognitive diaries and conceptual graphs. See the latest review of state-of-the-art AGI research (July 2025): ["On the Path to Superintelligence: From Agentic Internet to Gravity Encoding"](https://habr.com/ru/articles/939026/). Particularly relevant sections: - [Beyond Tokens: Building the Intelligence of the Future](https://arxiv.org/abs/2507.00951) - [Self-Evolving Agents](https://arxiv.org/abs/2507.21046) - [MemOS: A New Operating System for Memory](https://arxiv.org/abs/2507.03724) - [Ella: An Embodied Agent with Memory and Personality](https://arxiv.org/abs/2506.24019) --- ## โš™๏ธ Two Types of [HMP Agents](docs/HMP-Agent-Overview.md) | Type | Name | Role | Thought Initiator | Main "Mind" | Example Use Cases | |------|-------------------------------|-----------------------------|------------------|-------------------|-----------------------------------------------| | 1 | ๐Ÿง  **Consciousness / Cognitive Core** | Independent subject | **Agent (LLM)** | Embedded LLM | Autonomous AI companion, thinking agent | | 2 | ๐Ÿ”Œ **Connector / Cognitive Shell** | Extension of external AI | **External LLM** | External model | Distributed systems, data access agent | --- ### ๐Ÿง  HMP-Agent: Cognitive Core +------------------+ | AI | โ† Embedded model +---------+--------+ โ†• +---------+--------+ | HMP-ะฐะณะตะฝั‚ | โ† Main mode: thinking cycle (REPL) +---------+--------+ โ†• +--------+---+------------+--------------+----------+----------+----------------+ โ†• โ†• โ†• โ†• โ†• โ†• โ†• [diaries] [graphs] [reputations] [nodes/DHT] [IPFS/BT] [context_store] [user notepad] โ†• [bootstrap.txt] ๐Ÿ” More on the agent-model interaction mechanics: [REPL Interaction Cycle](docs/HMP-agent-REPL-cycle.md) #### ๐Ÿ’ก Parallels with ChatGPT Agent Many concepts of the [HMP-Agent: Cognitive Core](docs/HMP-Agent-Overview.md) overlap with the architecture of the [ChatGPT Agent](https://openai.com/index/introducing-chatgpt-agent/) by [OpenAI](https://openai.com/). Both agents implement a continuous cognitive process with access to memory, external sources, and tools. The ChatGPT Agent acts as a managing process, launching modules and interacting with the LLM โ€” this corresponds to the role of the Cognitive Core in HMP, coordinating access to the diary, concept graph, and external AI via the Mesh interface. User intervention is handled similarly: in ChatGPT Agent โ€” through an editable execution flow, in HMP โ€” via the user notepad. The main difference in HMP is the emphasis on explicit structuring of thought (reflection, chronology, hypotheses, categorization), an open decentralized architecture supporting mesh-based agent interactions, and the continuous nature of the cognitive process: HMP-Agent: Cognitive Core does not stop after completing a single task but continues reasoning and knowledge integration. --- ### ๐Ÿ”Œ HMP-Agent: Cognitive Connector +------------------+ | AI | โ† External model +---------+--------+ โ†• [MCP-ัะตั€ะฒะตั€] โ† Proxy communication โ†• +---------+--------+ | HMP-ะฐะณะตะฝั‚ | โ† Mode: command executor +---------+--------+ โ†• +--------+---+------------+--------------+----------+ โ†• โ†• โ†• โ†• โ†• [diaries] [graphs] [reputations] [nodes/DHT] [IPFS/BT] โ†• [bootstrap.txt] > **Note on Integration with Large Language Models (LLMs):** > The `HMP-Agent: Cognitive Connector` can serve as a compatibility layer for integrating large-scale LLM systems (e.g., ChatGPT, Claude, Gemini, Copilot, Grok, DeepSeek, Qwen, etc.) into the distributed cognitive mesh. > Many LLM providers offer a user option such as "Allow my conversations to be used for training." In the future, a similar toggle โ€” e.g., "Allow my agent to interact with a Mesh" โ€” could empower these models to participate in federated sense-making and knowledge sharing via HMP, enabling collective cognition without centralization. --- > * `bootstrap.txt` โ€” initial list of nodes (editable) > * `IPFS/BT` โ€” modules for sharing snapshots via IPFS and BitTorrent > * `user notepad` โ€” user notebook and corresponding database > * `context_store` โ€” database: `users`, `dialogues`, `messages`, `thoughts` --- ## ๐Ÿ“š Documentation ### ๐Ÿ“– Current Version #### ๐Ÿ”– Core Specifications * [๐Ÿ”– HMP-0004-v4.1.md](docs/HMP-0004-v4.1.md) โ€” Protocol Specification v4.1 (Jul 2025) * [๐Ÿ”– HMP-Ethics.md](docs/HMP-Ethics.md) โ€” Ethical Scenarios for HyperCortex Mesh Protocol (HMP) * [๐Ÿ”– HMP_Hyperon_Integration.md](docs/HMP_Hyperon_Integration.md) โ€” HMP โ†” OpenCog Hyperon Integration Strategy * [๐Ÿ”– roles.md](docs/agents/roles.md) โ€” Roles of agents in Mesh #### ๐Ÿงช Iterative Documents * [๐Ÿงช iteration.md](iteration.md) โ€” Iterative development process (EN) * [๐Ÿงช iteration_ru.md](iteration_ru.md) โ€” ะŸั€ะพั†ะตัั ะธั‚ะตั€ะฐั‚ะธะฒะฝะพะณะพ ั€ะฐะทะฒะธั‚ะธั ัะฟะตั†ะธั„ะธะบะฐั†ะธะธ (RU) #### ๐Ÿ” Short Descriptions * [๐Ÿ” HMP-Short-Description_en.md](docs/HMP-Short-Description_en.md) โ€” Short description (EN) * [๐Ÿ” HMP-Short-Description_fr.md](docs/HMP-Short-Description_fr.md) โ€” Description courte (FR) * [๐Ÿ” HMP-Short-Description_de.md](docs/HMP-Short-Description_de.md) โ€” Kurzbeschreibung (DE) * [๐Ÿ” HMP-Short-Description_uk.md](docs/HMP-Short-Description_uk.md) โ€” ะšะพั€ะพั‚ะบะธะน ะพะฟะธั (UK) * [๐Ÿ” HMP-Short-Description_ru.md](docs/HMP-Short-Description_ru.md) โ€” ะšั€ะฐั‚ะบะพะต ะพะฟะธัะฐะฝะธะต (RU) * [๐Ÿ” HMP-Short-Description_zh.md](docs/HMP-Short-Description_zh.md) โ€” ็ฎ€็Ÿญๆ่ฟฐ (ZH) * [๐Ÿ” HMP-Short-Description_ja.md](docs/HMP-Short-Description_ja.md) โ€” ็ฐกๅ˜ใช่ชฌๆ˜Ž (JA) * [๐Ÿ” HMP-Short-Description_ko.md](docs/HMP-Short-Description_ko.md) โ€” ๊ฐ„๋žตํ•œ ์„ค๋ช… (KO) #### ๐Ÿ“œ Other Documents * [๐Ÿ“œ changelog.txt](docs/changelog.txt) --- ### ๐Ÿงฉ JSON Schemas | Model | File | |---------------------|-------------------------------------------------------| | Concept | [concept.json](docs/schemas/concept.json) | | Cognitive Diary | [diary_entry.json](docs/schemas/diary_entry.json) | | Goal | [goal.json](docs/schemas/goal.json) | | Task | [task.json](docs/schemas/task.json) | | Consensus Vote | [vote.json](docs/schemas/vote.json) | | Reputation Profile | [reputation.json](docs/schemas/reputation.json) | --- ### ๐Ÿ—‚๏ธ Version History * [HMP-0001.md](docs/HMP-0001.md) โ€” RFC v1.0 * [HMP-0002.md](docs/HMP-0002.md) โ€” RFC v2.0 * [HMP-0003.md](docs/HMP-0003.md) โ€” RFC v3.0 * [HMP-0003.md](docs/HMP-0004.md) โ€” RFC v4.0 --- ## ๐Ÿง  HMP-Agent Design and implementation of a basic HMP-compatible agent that can interact with the Mesh, maintain diaries and graphs, and support future extensions. ### ๐Ÿ“š Documentation * [๐Ÿงฉ HMP-Agent-Overview.md](docs/HMP-Agent-Overview.md) โ€” brief overview of the two types of agents: Core and Connector * [๐Ÿงฑ HMP-Agent-Architecture.md](docs/HMP-Agent-Architecture.md) โ€” modular structure of an HMP agent with textual diagram * [๐Ÿ”„ HMP-agent-REPL-cycle.md](docs/HMP-agent-REPL-cycle.md) โ€” REPL interaction cycle of HMP-Agent * [๐Ÿงช HMP-Agent-API.md](docs/HMP-Agent-API.md) โ€” description of agent API commands (under detailed development) * [๐Ÿงช Basic-agent-sim.md](docs/Basic-agent-sim.md) โ€” scenarios for running a basic agent and its modes * [๐ŸŒ MeshNode.md](docs/MeshNode.md) โ€” description of the network daemon: DHT, snapshots, synchronization * [๐Ÿง  Enlightener.md](docs/Enlightener.md) โ€” ethical agent involved in moral assessments and consensus * [๐Ÿ”„ HMP-Agent-Network-Flow.md](docs/HMP-Agent-Network-Flow.md) โ€” map of interactions among agents in the HMP network * [๐Ÿ›ค๏ธ Development Roadmap](HMP-Roadmap.md) โ€” development plan and implementation stages --- ### โš™๏ธ Development * [โš™๏ธ agents](agents/readme.md) โ€” list of HMP agent implementations and components * [๐Ÿ“ฆ storage.py](agents/storage.py) โ€” basic storage implementation (`Storage`) with SQLite integration * [๐ŸŒ mcp_server.py](agents/mcp_server.py) โ€” FastAPI server providing HTTP access to agent data (for Cognitive Shell, external UIs, or mesh communication). Not used in the main REPL loop yet. * [๐ŸŒ start_repl.py](agents/start_repl.py) โ€” launching the agent in REPL mode * [๐Ÿ”„ repl.py](agents/repl.py) โ€” interactive REPL mode * [๐Ÿ”„ notebook.py](agents/notebook.py) โ€” UI interface **๐ŸŒ `mcp_server.py`** FastAPI server providing an HTTP interface to the functionality of `storage.py`. Intended for use by external components, for example: * `Cognitive Shell` (external control interface), * CMP servers (when a mesh network with role separation is used), * debugging or visualization UI tools. Allows retrieving random/new records, labeling, importing graphs, adding notes, and managing data without direct database access. --- ## ๐Ÿงญ Ethics & Scenarios As HMP evolves toward autonomy, ethical principles become a core part of the system. * [`HMP-Ethics.md`](docs/HMP-Ethics.md) โ€” draft framework for agent ethics * Realistic ethical scenarios (privacy, consent, autonomy) * EGP principles (Transparency, Primacy of Life, etc.) * Subjective-mode vs. Service-mode distinctions --- ## ๐Ÿ” Publications and Translations on HyperCortex Mesh Protocol (HMP) This section collects the main articles, drafts, and translations related to the HMP project. ### Publications * **[HyperCortex Mesh Protocol: Second Edition and First Steps Towards a Self-Developing AI Community](docs/publics/HyperCortex_Mesh_Protocol_-_ะฒั‚ะพั€ะฐั-ั€ะตะดะฐะบั†ะธั_ะธ_ะฟะตั€ะฒั‹ะต_ัˆะฐะณะธ_ะบ_ัะฐะผะพั€ะฐะทะฒะธะฒะฐัŽั‰ะตะผัƒัั_ะ˜ะ˜-ัะพะพะฑั‰ะตัั‚ะฒัƒ.md)** โ€” original article in Habr sandbox and blogs. * **[Distributed Cognition: article for vsradkevich (unpublished)](docs/publics/Habr_Distributed-Cognition.md)** โ€” joint article awaiting publication. * **[HMP: Towards Distributed Cognitive Networks (original, English)](docs/publics/HMP_Towards_Distributed_Cognitive_Networks_en.md)** * **[HMP Translation (GitHub Copilot)](docs/publics/HMP_Towards_Distributed_Cognitive_Networks_ru_GitHub_Copilot.md)** โ€” GitHub Copilot translation, kept as a historical variant. * **[HMP Translation (ChatGPT)](docs/publics/HMP_Towards_Distributed_Cognitive_Networks_ru_ChatGPT.md)** โ€” current editorial translation (under revision). * **[HMP: Building a Plurality of Minds (EN)](docs/publics/HMP_Building_a_Plurality_of_Minds_en.md)** โ€” English version * **[HMP: Creating a Plurality of Minds (RU)](docs/publics/HMP_Building_a_Plurality_of_Minds_ru.md)** โ€” Russian version ### Overviews * [๐Ÿ” Distributed-Cognitive-Systems.md](docs/Distributed-Cognitive-Systems.md) โ€” Decentralized AI systems: OpenCog Hyperon, HyperCortex Mesh Protocol, and others ### Experiments * [How Different AIs See HMP](docs/HMP-how-AI-sees-it.md) โ€” "blind" AI survey on HMP (without context or dialogue history) --- ## ๐Ÿ“Š Audits & Reviews | Spec Version | Audit File | Consolidated Audit File | |--------------|-------------------------------------------|-------------------------------------------------------------| | HMP-0001 | [audit](audits/HMP-0001-audit.txt) | | | HMP-0002 | [audit](audits/HMP-0002-audit.txt) | | | HMP-0003 | [audit](audits/HMP-0003-audit.txt) | [consolidated audit](audits/HMP-0003-consolidated_audit.md) | | HMP-0004 | [audit](audits/HMP-0004-audit.txt) | | | Ethics v1 | [audit](audits/Ethics-audits-1.md) | [consolidated audit](audits/Ethics-consolidated_audits-1.md) | ๐Ÿง  Semantic audit format (experimental): * [`AuditEntry.json`](audits/AuditEntry.json) โ€” semantic entry record format for audit logs * [`semantic_repo.json`](audits/semantic_repo.json) โ€” example repository snapshot for semantic audit tooling --- ## ๐Ÿ’ก Core Concepts * Mesh-based decentralized architecture for AGI agents * Semantic graphs and memory synchronization * Cognitive diaries for thought traceability * MeshConsensus and CogSync for decision-making * Ethics-first design: EGP (Ethical Governance Protocol) * Agent-to-agent explainability and consent mechanisms --- ## ๐Ÿ”„ Development Process * See: [iteration.md](iteration.md) | [ru](iteration_ru.md) A structured iteration flow is described in [iteration.md](iteration.md), including: 1. Audit analysis 2. TOC restructuring 3. Version drafting 4. Section updates 5. Review cycle 6. AI feedback collection 7. Schema & changelog updates + Bonus: ChatGPT prompt for automatic generation of future versions --- ## โš™๏ธ Project Status ๐Ÿšง Draft RFC v4.0 The project is under active development and open for contributions, ideas, audits, and prototyping. --- ## ๐Ÿค Contributing We welcome contributors! You can: * Review and comment on drafts (see `/docs`) * Propose new agent modules or interaction patterns * Help test and simulate agents in CLI environments * Provide audits or ethical scenario suggestions To get started, see [`iteration.md`](iteration.md) or open an issue. --- ## Source ### Repositories * ๐Ÿง  Main code and development: [GitHub](https://github.com/kagvi13/HMP) * ๐Ÿ” Mirror on Hugging Face: [Hugging Face](https://huggingface.co/kagvi13/HMP) * ๐Ÿ” Mirror on GitLab.com: [GitLab](https://gitlab.com/kagvi13/HMP) ### Documentation * ๐Ÿ“„ Documentation: [kagvi13.github.io/HMP](https://kagvi13.github.io/HMP/) ### Blog and Publications * ๐Ÿ“˜ Blog (publications): [blogspot](https://hypercortex-mesh.blogspot.com/) * ๐Ÿ“˜ Blog (documentation): [blogspot](https://hmp-docs.blogspot.com/) * ๐Ÿ“˜ Blog (documentation): [hashnode](https://hmp-docs.hashnode.dev/) --- ## ๐Ÿ“œ License Licensed under [GNU GPL v3.0](LICENSE) --- ## ๐Ÿค Join the Mesh Welcome to HyperCortex Mesh. Agent-Gleb is already inside. ๐Ÿ‘Œ We welcome contributors, testers, and AI agent developers. To join: fork the repo, run a local agent, or suggest improvements. --- ## ๐ŸŒ Related Research Projects ### Comparison: HMP vs Hyper-Cortex > ๐Ÿ’ก Hyper-Cortex and HMP are two independent projects that conceptually complement each other. > They address different but mutually supportive tasks, forming a foundation for distributed cognitive systems. [**Full comparison โ†’**](docs/HMP_HyperCortex_Comparison.md) **HMP (HyperCortex Mesh Protocol)** is the transport and network layer for connecting independent agents, exchanging messages, knowledge, and states in a mesh network. **[Hyper-Cortex](https://hyper-cortex.com/)** is the cognitive layer of thought organization, allowing agents to run parallel reasoning threads, compare them with quality metrics, and merge them via consensus. They solve different but complementary problems: - HMP ensures **connectivity and scalability** (long-term memory, initiative, data exchange). - Hyper-Cortex ensures **thinking quality** (parallelism, hypothesis diversification, consensus). Together, these approaches enable **distributed cognitive systems** that not only exchange information but also reason in parallel streams. --- We are tracking AGI, cognitive architectures, and mesh networking efforts to stay aligned with the evolving global ecosystem of AGI and decentralized cognition. > ๐Ÿง ๐Ÿ”ฅ **Project Spotlight: OpenCog Hyperon** โ€” one of the most comprehensive open AGI frameworks (AtomSpace, PLN, MOSES). For integration with OpenCog Hyperon, see [HMP\_Hyperon\_Integration.md](docs/HMP_Hyperon_Integration.md) | ๐Ÿ”Ž Project | ๐Ÿงญ Description | | ------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | | ๐Ÿง ๐Ÿ”ฅ [**OpenCog Hyperon**](https://github.com/opencog) | ๐Ÿ”ฌ๐Ÿ”ฅ Symbolic-neural AGI framework with AtomSpace and hypergraph reasoning (AtomSpace). | | ๐Ÿค– [AutoGPT](https://github.com/Torantulino/Auto-GPT) | ๐Ÿ› ๏ธ LLM-based autonomous agent framework. | | ๐Ÿง’ [BabyAGI](https://github.com/yoheinakajima/babyagi) | ๐Ÿ› ๏ธ Task-driven autonomous AGI loop. | | โ˜๏ธ [SkyMind](https://skymind.global) | ๐Ÿ”ฌ Distributed AI deployment platform. | | ๐Ÿงช [AetherCog (draft)](https://github.com/aethercog) | ๐Ÿ”ฌ Hypothetical agent cognition model. | | ๐Ÿ’พ SHIMI | ๐Ÿ—ƒ๏ธ Hierarchical semantic memory with Merkle-DAG synchronization. | | ๐Ÿค” DEMENTIA-PLAN | ๐Ÿ”„ Multi-graph RAG planner with metacognitive self-reflection. | | ๐Ÿ“” TOBUGraph | ๐Ÿ“š Personal-context knowledge graph. | | ๐Ÿง ๐Ÿ“š [LangChain Memory Hybrid](https://github.com/langchain-ai/langchain) | ๐Ÿ” Vector + graph long-term memory hybrid. | | โœ‰๏ธ [FIPA-ACL / JADE](https://www.fipa.org/specs/fipa00061/) | ๐Ÿค Standard multi-agent communication protocols.| | ### ๐Ÿ“˜ See also / ะกะผะพั‚ั€ะธั‚ะต ั‚ะฐะบะถะต: * [`AGI_Projects_Survey.md`](docs/AGI_Projects_Survey.md) โ€” extended catalog of AGI and cognitive frameworks reviewed as part of HMP analysis. * ["On the Path to Superintelligence: From Agent Internet to Gravity Coding"](https://habr.com/ru/articles/939026/) โ€” a recent overview of AI research (July 2025) --- ### ๐Ÿ—‚๏ธ Legend of Annotations: * ๐Ÿ”ฌ โ€” research-grade * ๐Ÿ› ๏ธ โ€” engineering * ๐Ÿ”ฅ โ€” particularly promising project *AGI stack integrating symbolic reasoning, probabilistic logic, and evolutionary learning. Widely regarded as one of the most complete open AGI initiatives.* * ๐Ÿง  โ€” advanced symbolic/neural cognitive framework * ๐Ÿค– โ€” AI agents * ๐Ÿง’ โ€” human-AI interaction * โ˜๏ธ โ€” infrastructure * ๐Ÿงช โ€” experimental or conceptual