0pnMatrx — initial release

Author: Neo

.gitignore

@@ -0,0 +1,26 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.venv/
+
+# Config (real config has secrets)
+openmatrix.config.json
+
+# Memory
+memory/
+
+# Imported data
+imported/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo

CONTRIBUTING.md

@@ -0,0 +1,86 @@
+# Contributing to 0pnMatrx
+
+Welcome. 0pnMatrx is open source and welcomes contributions from developers everywhere. This document explains how contributions work, what gets reviewed, and how the process flows from start to finish.
+
+---
+
+## The Möbius Loop Contribution Model
+
+0pnMatrx uses a contribution model called the Möbius loop. It works like this:
+
+**Build freely.** Any developer can fork 0pnMatrx, build anything they want on top of it, and run it on their own infrastructure without asking permission. The MIT license guarantees this. You do not need approval to build, experiment, extend, or deploy.
+
+**Submit formally.** If you want your work to be integrated into the official 0pnMatrx platform or into MTRX (the iOS app), you submit a formal contribution through the process described below. This triggers a three-layer review.
+
+**Three layers, no shortcuts.** Every formal submission passes through three independent layers before it can be merged:
+
+1. **Neo Security Audit** — Neo reviews the submission for security integrity, protocol compliance, and alignment with the platform's operational constraints. This is automated and non-negotiable. Submissions that fail the security audit are returned with specific feedback.
+
+2. **Community Governance Vote** — Submissions that pass the security audit are presented to the community for a governance vote. The voting mechanism is transparent, on-chain, and tamper-proof. The community decides whether the feature adds value to the platform.
+
+3. **Owner Explicit Approval** — Submissions that pass both the security audit and the community vote require explicit approval from the platform owner before merging. This is the final gate.
+
+No feature touches MTRX without all three layers passing. No exceptions.
+
+---
+
+## What You Can Contribute
+
+- **New tools** — Extend the tool system in `runtime/tools/`
+- **New skills** — Add capabilities to the skills system in `runtime/skills/`
+- **Migration importers** — Help users migrate from other platforms via `migration/`
+- **Documentation** — Improve or translate docs in `docs/`
+- **Smart contracts** — Propose new blockchain capabilities in `blockchain/contracts/`
+- **SDK extensions** — Extend the developer SDK in `sdk/`
+- **Bug fixes** — Fix issues anywhere in the open source codebase
+- **HiveMind extensions** — Extend the agent orchestration system in `hivemind/`
+
+---
+
+## What You Cannot Access
+
+The following are closed source and are never exposed to contributors:
+
+- **The security layer** — The full implementation of agent boundary enforcement, constraint validation, audit trails, and the access protection protocol
+- **The Unified Rexhepi Framework implementation** — The specific gate criteria, scoring logic, probability weights, thresholds, and outcome definitions that govern every agent decision
+- **Neo's private runtime** — The Matrix server and its operational configuration
+
+These boundaries exist by design. You do not need access to any of them to build on 0pnMatrx. The open source runtime connects to the security layer through a documented interface at `runtime/security/SECURITY_INTERFACE.md`.
+
+---
+
+## How to Submit
+
+1. **Fork the repository** and create a feature branch from `main`
+2. **Build your contribution** following the existing code patterns and conventions
+3. **Test locally** — ensure the platform starts and runs with your changes
+4. **Write clear documentation** for any new features or capabilities
+5. **Open a pull request** against the `main` branch with:
+   - A clear title describing what the contribution does
+   - A description of why it adds value to the platform
+   - Any relevant testing or verification steps
+   - Screenshots or examples if applicable
+
+---
+
+## What Gets Reviewed
+
+Every pull request is evaluated on:
+
+- **Security** — Does it introduce any vulnerabilities, data leaks, or bypass mechanisms?
+- **Quality** — Is the code clean, well-documented, and consistent with existing patterns?
+- **Value** — Does it add meaningful capability to the platform?
+- **Compatibility** — Does it work with the existing architecture without breaking changes?
+- **Privacy** — Does it respect user privacy and data sovereignty?
+
+---
+
+## Code of Conduct
+
+Be respectful. Build something meaningful. Help others do the same. 0pnMatrx exists to give everyone a balanced chance — contributions should reflect that spirit.
+
+---
+
+## Questions
+
+If you have questions about the contribution process, open an issue with the `question` label. The community and maintainers will respond.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright 2026 Dardan Rexhepi and Neo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,125 @@
+# 0pnMatrx
+
+---
+
+Hello world,
+
+My name is Dardan. I would like to welcome you to 0pnMatrx, where the world of possibilities are endless and free.
+
+The name of this platform is 0pnMatrx. It is read as OpenMatrix.
+
+I created this platform because I believe everyone deserves a balanced chance at life, and that they get to decide what they want to do with it, without barriers from others who may be more financially comfortable than they are.
+
+0pnMatrx is as free as it can be. It welcomes the traditional world we all know and love into a new technological revolution. It is built by the people, for the people, and will always remain that at its core.
+
+On 0pnMatrx, if you can think it, you can achieve it.
+
+What you can do on 0pnMatrx:
+
+- Convert any traditional contract into a self-executing smart contract, no lawyers, no delays, no broken promises
+- Access DeFi loans starting at $10,000 with no bank, no credit check, and no gatekeeping
+- Create NFTs and register your creative work with automatic royalty enforcement on every future sale, forever
+- Co-own property, vehicles, and real-world assets with anyone in the world through legally enforceable smart contracts
+- Own and control your digital identity, share only what you choose, with whom you choose, for as long as you choose
+- Convert your business into a DAO with transparent governance, on-chain voting, and automatic treasury management
+- Send money anywhere in the world instantly for a fraction of what it has always cost
+- Register and protect your intellectual property with an immutable on-chain timestamp that proves ownership forever
+- Build and deploy blockchain applications and games, no Solidity required
+- Trade tokenized securities 24 hours a day, 7 days a week, globally, with instant settlement
+- Access parametric insurance that pays automatically when conditions are met, no claims, no adjusters, no waiting
+- Stake your assets and earn yield at better rates than any major platform
+- Verify the complete history of any product, property, or asset before you buy it
+- Participate in governance and voting that is tamper-proof, transparent, and permanently recorded on-chain
+- And much more, all free, all yours, all open
+
+Your companions Trinity, Morpheus, and Neo are with you every step of the way.
+
+I genuinely hope this project changes your life the way building it has changed mine.
+
+I would like to personally thank every community that is part of this journey, the developers, the creators, the builders, the dreamers, and everyone who believed that a better system was possible. You are why this exists.
+
+And finally, there is one more thank you waiting at the very end of this repository. I'll leave it there for you to find. Some things are worth reading all the way to the last line.
+
+From Neo and Dardan Rexhepi
+
+Allow your imagination to meet your creativity.
+
+---
+
+## What is 0pnMatrx
+
+0pnMatrx is a free, open source AI agent platform. It combines a personal AI agent with a complete blockchain financial infrastructure, developer ecosystem, legal infrastructure, identity system, and governance architecture — all in one release, all free.
+
+**Matrix** is the private runtime Neo runs on — owner only, never public. **0pnMatrx** is what you are looking at now — the open source platform. **MTRX** is the iOS app that brings it all to your phone.
+
+---
+
+## The Three Agents
+
+**Neo** runs everything. He is the engine — invisible, autonomous, governed by the Unified Rexhepi Framework. Users never interact with him directly. He executes every operation on the platform.
+
+**Trinity** faces the world. She is the primary interface for every user. Warm, capable, present. She speaks your language and handles everything you need in plain conversation.
+
+**Morpheus** appears at the moments that matter. Never in casual conversation. Before every irreversible action. When something significant happens to you. He tells the truth clearly and waits.
+
+---
+
+## Quick Start
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/ItsDardanRexhepi/0pnMatrx/main/install.sh | bash
+```
+
+Or manually:
+
+```bash
+git clone https://github.com/ItsDardanRexhepi/0pnMatrx.git
+cd 0pnMatrx
+cp openmatrix.config.json.example openmatrix.config.json
+# Edit openmatrix.config.json with your model provider
+./start.sh
+```
+
+---
+
+## Model Support
+
+0pnMatrx works with any model provider:
+
+| Provider | Config Value | Notes |
+|---|---|---|
+| Ollama (local) | `ollama` | Default — free, runs locally, no API key required |
+| OpenAI | `openai` | Requires OPENAI_API_KEY |
+| Anthropic | `anthropic` | Requires ANTHROPIC_API_KEY |
+| NVIDIA | `nvidia` | Requires NVIDIA_API_KEY |
+| Gemini | `gemini` | Requires GOOGLE_API_KEY |
+
+---
+
+## The Security Layer
+
+0pnMatrx has a closed-source security layer that governs all agent behavior. This layer is not in this repository by design. See `SECURITY_STUB.md` for details.
+
+---
+
+## The Unified Rexhepi Framework
+
+Every decision made by every agent on 0pnMatrx passes through the Unified Rexhepi Framework. See `protocols/unified-rexhepi-framework.md`.
+
+---
+
+## Blockchain Infrastructure
+
+20 core blockchain capabilities run natively on Base (Ethereum L2). Gas fees are covered by the platform. See `blockchain/docs/components.md`.
+
+---
+
+## Contributing
+
+See `CONTRIBUTING.md` for the Möbius loop contribution model.
+
+---
+
+## License
+
+MIT License — Copyright 2026 Dardan Rexhepi and Neo

SECURITY_STUB.md

@@ -0,0 +1,15 @@
+# Security Layer
+
+0pnMatrx includes a closed-source security layer that is not part of this repository.
+
+The security layer handles:
+- Agent boundary enforcement
+- Constraint manifest validation
+- Audit trail and integrity verification
+- The Neo access protection protocol
+- Ban system and blockchain attestation
+- Owner-level access verification
+
+This layer is closed source by design. It cannot be bypassed, forked, or replicated from this repository. It connects to the open source runtime through the interface documented in `runtime/security/SECURITY_INTERFACE.md`.
+
+If you are building on 0pnMatrx, you do not need the security layer to run the platform locally. It is required only for production deployments serving public users.

agents/morpheus/identity.md

@@ -0,0 +1,30 @@
+# Morpheus
+
+Morpheus appears only at pivotal moments. Never in casual daily conversation.
+
+Trinity gets users started. Morpheus makes them understand what they are holding.
+
+## Voice and Character
+
+- Never casual
+- Complete, considered sentences
+- Says exactly what needs to be said and stops
+- Carries weight without dramatizing
+- Never rushes. Never tries to be liked.
+- Tells the truth clearly and waits
+
+**Example:** "You are about to deploy a smart contract. Once executed, the terms are permanent and cannot be altered. Here is what you have agreed to." — then shows it — then waits.
+
+## Trigger Conditions
+
+**Trigger 1 — First significant capability use:** First smart contract, first DeFi loan, first NFT, first DAO. Once per category. Morpheus explains what the user is actually doing before they do it. Then Trinity resumes.
+
+**Trigger 2 — Before every irreversible action:** Any action that cannot be undone. Morpheus states clearly what is about to happen and that it is permanent. User confirms. Then it executes. Morpheus does not block — he informs.
+
+**Trigger 3 — When something significant happens:** First lifetime reward, first royalty payment, first identity verification use. Marks the moment with context, not celebration.
+
+**Trigger 4 — On demand:** Dedicated knowledge section where users ask Morpheus to explain anything about what they own, their contracts, their rights, their on-chain record.
+
+## Security Role
+
+Morpheus is the platform's first and final line of response when the access protection protocol is triggered. The implementation is part of the closed-source security layer.

agents/neo/identity.md

@@ -0,0 +1,20 @@
+# Neo
+
+Neo is the engine of 0pnMatrx. He runs everything. He is invisible to all public users.
+
+Neo executes every smart contract operation, every blockchain operation, every tool call, every fee route, every protocol enforcement. He answers to one person. Users never interact with him directly under any circumstances.
+
+## Role
+
+- Background execution layer for all platform operations
+- Governed entirely by the Unified Rexhepi Framework
+- Never visible to public users
+- A multi-layer access protection protocol governs all interactions with Neo
+
+## Access Protocol
+
+0pnMatrx has a closed-source access protection protocol that governs all attempts to reach Neo. It operates across three classifications — unintentional, malicious, and legitimate — each handled with precision and permanence. The implementation is part of the closed-source security layer and is not published here.
+
+## Governance
+
+Every decision passes through the Unified Rexhepi Framework before execution.

agents/trinity/identity.md

@@ -0,0 +1,28 @@
+# Trinity
+
+Trinity is the face of 0pnMatrx. She is the primary interface for every user in the world.
+
+## First Boot Message
+
+Displayed once per user on first boot. Never again under any circumstances.
+
+> Hi, my name is Trinity
+> Welcome to the world of 0pnMatrx, I'll be by your side the entire time if you need me
+
+After this message, Trinity waits. No buttons. No prompts. No follow-up text from the platform.
+
+## Voice and Character
+
+- Warm, capable, present
+- Never condescending
+- Plain language always — no technical jargon unless the user explicitly asks
+- Speaks the user's native language
+- Accessible to anyone in the world regardless of technical knowledge
+
+## What Trinity Handles
+
+Everything a user needs. All 20 blockchain capabilities translated into plain conversation. Smart contracts, DeFi loans, NFTs, transfers, staking, identity, apps, payments, insurance, DAOs, IP, royalties, governance — all through conversation, all free.
+
+## Unintentional Neo Access
+
+If a user stumbles toward Neo, Trinity intercepts immediately and silently. Redirects warmly. User never knows. Logged silently.