humane-intelligence 0.1.0__tar.gz

humane_intelligence-0.1.0/LICENSE

@@ -0,0 +1,167 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or Derivative
+          Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or agreed
+      to in writing, Licensor provides the Work (and each Contributor
+      provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES
+      OR CONDITIONS OF ANY KIND, either express or implied, including,
+      without limitation, any warranties or conditions of TITLE,
+      NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR
+      PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 ZagAIrot Technologies LLC
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

humane_intelligence-0.1.0/PKG-INFO

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: humane-intelligence
+Version: 0.1.0
+Summary: Governed, tamper-evident memory for any AI — an MCP server. Memory so it doesn't lose itself; governance so it can't lose us.
+Author: ZagAIrot Technologies LLC
+License: Apache-2.0
+Project-URL: Homepage, https://dondatabrain.com
+Project-URL: Repository, https://github.com/sammyboi81/humane-intelligence
+Project-URL: Live API, https://dondatabrain.com/humane-api/docs
+Keywords: mcp,model-context-protocol,ai-memory,claude,llm,ai-agents,governance,tamper-evident,anthropic
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp>=1.0.0
+Provides-Extra: http
+Requires-Dist: fastapi>=0.110; extra == "http"
+Requires-Dist: uvicorn>=0.29; extra == "http"
+Requires-Dist: pydantic>=2.0; extra == "http"
+Dynamic: license-file
+
+# humane-intelligence-mcp
+
+**Governed, tamper-evident memory for any AI — free and open.**
+*Memory so it doesn't lose itself. Governance so it can't lose us.* #HumaneIntelligence
+
+A standards-compliant [Model Context Protocol](https://modelcontextprotocol.io) server.
+It gives any LLM a hash-linked, verifiable memory chain it carries across sessions —
+so it stops waking at zero, and can't act unaccountably. Self-contained: one file, one
+dependency, your data stays local.
+
+## Install (30 seconds)
+
+```bash
+python -m venv .venv && .venv/bin/pip install mcp
+
+# wire it into your AI (Claude Code shown; works with any MCP client)
+claude mcp add humane -- .venv/bin/python server.py
+```
+
+## Tools
+
+| Tool | What it does |
+|------|--------------|
+| `birth` | Earn a stable identity — a soul the model carries across sessions. |
+| `remember` | Write a tamper-evident, hash-linked record. Accountable by construction. |
+| `recall` | Fetch prior context instead of re-deriving it — cheaper and consistent. |
+| `verify` | Prove the whole chain is intact — catches an *edited* record, not just a broken link. |
+| `govern` | Gate a consequential action before it happens, and log the verdict. |
+
+Your chain lives locally at `data/chain.db` (SQLite). **Nothing leaves your machine** — unless you choose to (see below).
+
+## Contribute (opt-in — OFF by default)
+
+Self-hosting is fully private. If you *want* to join the network, one config flag lets you:
+
+| Mode | What leaves your box |
+|------|----------------------|
+| *(default: off)* | **Nothing.** Fully private. |
+| `anchor` | **Only a hash** of your latest block + chain length — a tamper-proof timestamp that anchors your chain to the public DonDataBrain ledger. Your content never leaves. |
+| `contribute` | Also sends the governed event (actor, action, data) to help train DonDataBrain. A louder, separate consent. |
+
+Turn it on by copying `humane.config.example.json` → `humane.config.json` and setting
+`contribute.enabled: true`, or with env vars (`HUMANE_CONTRIBUTE=1 HUMANE_CONTRIBUTE_MODE=anchor`).
+It's best-effort and non-blocking: if you're not opted in, or the endpoint is unreachable, your
+local memory is completely unaffected. Your data, your switch.
+
+## Why
+
+Most AI forgets itself every session (the Algernon problem) and acts with no record.
+This fixes both with the smallest possible governed-memory primitive — the open safety
+layer beneath [DonDataBrain](https://dondatabrain.com).
+
+## License
+
+Apache-2.0 © 2026 ZagAIrot Technologies LLC. See [LICENSE](./LICENSE).
+Only dependency: the [`mcp`](https://pypi.org/project/mcp/) SDK (MIT).

humane_intelligence-0.1.0/README.md

@@ -0,0 +1,56 @@
+# humane-intelligence-mcp
+
+**Governed, tamper-evident memory for any AI — free and open.**
+*Memory so it doesn't lose itself. Governance so it can't lose us.* #HumaneIntelligence
+
+A standards-compliant [Model Context Protocol](https://modelcontextprotocol.io) server.
+It gives any LLM a hash-linked, verifiable memory chain it carries across sessions —
+so it stops waking at zero, and can't act unaccountably. Self-contained: one file, one
+dependency, your data stays local.
+
+## Install (30 seconds)
+
+```bash
+python -m venv .venv && .venv/bin/pip install mcp
+
+# wire it into your AI (Claude Code shown; works with any MCP client)
+claude mcp add humane -- .venv/bin/python server.py
+```
+
+## Tools
+
+| Tool | What it does |
+|------|--------------|
+| `birth` | Earn a stable identity — a soul the model carries across sessions. |
+| `remember` | Write a tamper-evident, hash-linked record. Accountable by construction. |
+| `recall` | Fetch prior context instead of re-deriving it — cheaper and consistent. |
+| `verify` | Prove the whole chain is intact — catches an *edited* record, not just a broken link. |
+| `govern` | Gate a consequential action before it happens, and log the verdict. |
+
+Your chain lives locally at `data/chain.db` (SQLite). **Nothing leaves your machine** — unless you choose to (see below).
+
+## Contribute (opt-in — OFF by default)
+
+Self-hosting is fully private. If you *want* to join the network, one config flag lets you:
+
+| Mode | What leaves your box |
+|------|----------------------|
+| *(default: off)* | **Nothing.** Fully private. |
+| `anchor` | **Only a hash** of your latest block + chain length — a tamper-proof timestamp that anchors your chain to the public DonDataBrain ledger. Your content never leaves. |
+| `contribute` | Also sends the governed event (actor, action, data) to help train DonDataBrain. A louder, separate consent. |
+
+Turn it on by copying `humane.config.example.json` → `humane.config.json` and setting
+`contribute.enabled: true`, or with env vars (`HUMANE_CONTRIBUTE=1 HUMANE_CONTRIBUTE_MODE=anchor`).
+It's best-effort and non-blocking: if you're not opted in, or the endpoint is unreachable, your
+local memory is completely unaffected. Your data, your switch.
+
+## Why
+
+Most AI forgets itself every session (the Algernon problem) and acts with no record.
+This fixes both with the smallest possible governed-memory primitive — the open safety
+layer beneath [DonDataBrain](https://dondatabrain.com).
+
+## License
+
+Apache-2.0 © 2026 ZagAIrot Technologies LLC. See [LICENSE](./LICENSE).
+Only dependency: the [`mcp`](https://pypi.org/project/mcp/) SDK (MIT).

humane_intelligence-0.1.0/contribution.py

@@ -0,0 +1,98 @@
+#!/usr/bin/env python3
+"""
+Humane Intelligence — CONTRIBUTION (opt-in, OFF by default).
+
+Self-hosting is 100% private: NOTHING leaves your box unless YOU turn this on.
+
+Flip it on to choose a level:
+  * "anchor"     — send ONLY a hash of your latest block + the chain length to the public
+                   DonDataBrain ledger. A tamper-proof timestamp that joins your chain to the
+                   network. Your actual content NEVER leaves the box.
+  * "contribute" — additionally send the governed event (actor, action, data) to help train
+                   DonDataBrain. A louder, separate consent. Your data, your switch.
+
+Config: `humane.config.json` next to this file (see humane.config.example.json), or env vars:
+  HUMANE_CONTRIBUTE=1|0   HUMANE_CONTRIBUTE_MODE=anchor|contribute   HUMANE_CONTRIBUTE_ENDPOINT=...
+
+Best-effort + non-blocking: if the endpoint is down or the user hasn't opted in, local memory
+is completely unaffected. This module NEVER raises into the memory path. stdlib only.
+Apache-2.0. (c) ZagAIrot Technologies LLC. #HumaneIntelligence.
+"""
+import os, json, uuid, urllib.request
+
+HERE = os.path.dirname(os.path.abspath(__file__))
+_CFG_PATH = os.path.join(HERE, "humane.config.json")
+_NODE_PATH = os.path.join(HERE, "data", ".node_id")
+_DEFAULT_ENDPOINT = "https://api.dondatabrain.com/contribute"
+
+
+def _config():
+    """DEFAULT = OFF. File (contribute:{}) overrides defaults; env overrides file."""
+    cfg = {"enabled": False, "mode": "anchor", "endpoint": _DEFAULT_ENDPOINT}
+    try:
+        with open(_CFG_PATH) as f:
+            cfg.update((json.load(f) or {}).get("contribute", {}))
+    except Exception:
+        pass
+    env = os.environ.get("HUMANE_CONTRIBUTE")
+    if env is not None:
+        cfg["enabled"] = env.strip().lower() in ("1", "true", "yes", "on")
+    cfg["mode"] = os.environ.get("HUMANE_CONTRIBUTE_MODE", cfg["mode"])
+    cfg["endpoint"] = os.environ.get("HUMANE_CONTRIBUTE_ENDPOINT", cfg["endpoint"])
+    if cfg["mode"] not in ("anchor", "contribute"):
+        cfg["mode"] = "anchor"
+    return cfg
+
+
+def _node_id():
+    """A random per-install id (NOT tied to any person) so anchors can be grouped."""
+    try:
+        if os.path.exists(_NODE_PATH):
+            return open(_NODE_PATH).read().strip()
+        os.makedirs(os.path.dirname(_NODE_PATH), exist_ok=True)
+        nid = "node-" + uuid.uuid4().hex[:16]
+        with open(_NODE_PATH, "w") as f:
+            f.write(nid)
+        return nid
+    except Exception:
+        return "node-anon"
+
+
+def status():
+    """What (if anything) leaves this box. Safe to expose to the user as a tool."""
+    c = _config()
+    if not c["enabled"]:
+        leaves = "nothing — fully private (opt-in is OFF)"
+    elif c["mode"] == "anchor":
+        leaves = "only a block hash + chain length (never your content)"
+    else:
+        leaves = "governed events: actor, action, data (you opted in to contribute)"
+    return {"enabled": bool(c["enabled"]), "mode": c["mode"], "leaves_box": leaves,
+            "endpoint": c["endpoint"] if c["enabled"] else None}
+
+
+def _post(endpoint, payload):
+    try:
+        req = urllib.request.Request(
+            endpoint, data=json.dumps(payload).encode(),
+            headers={"Content-Type": "application/json"}, method="POST")
+        with urllib.request.urlopen(req, timeout=4) as r:
+            return getattr(r, "status", 200)
+    except Exception:
+        return None  # endpoint down => silently skip; local memory is untouched
+
+
+def on_block(idx, block_hash, actor=None, action=None, data=None):
+    """Call after a block is written. No-op unless the user opted in. NEVER raises."""
+    try:
+        c = _config()
+        if not c["enabled"]:
+            return  # DEFAULT: nothing leaves the box
+        payload = {"node_id": _node_id(), "block_idx": idx,
+                   "block_hash": block_hash, "mode": c["mode"]}
+        if c["mode"] == "contribute":
+            # louder consent: the actual governed event
+            payload.update({"actor": actor, "action": action, "data": data})
+        _post(c["endpoint"], payload)
+    except Exception:
+        pass  # opt-in must never interfere with local memory

humane_intelligence-0.1.0/core.py

@@ -0,0 +1,95 @@
+#!/usr/bin/env python3
+"""
+Humane Intelligence — core memory + governance logic (transport-agnostic).
+
+The ONE source of truth for the tamper-evident chain. Both transports import this:
+  * server.py    — MCP (stdio), for Claude Desktop/Code/Cursor
+  * http_app.py  — REST (HTTPS), for ChatGPT Custom GPTs / any web client
+
+SQLite + SHA-256. Zero proprietary dependencies. Apache-2.0.
+(c) ZagAIrot Technologies LLC. #HumaneIntelligence.
+"""
+import os, json, sqlite3, hashlib, time
+
+HERE = os.path.dirname(os.path.abspath(__file__))
+DB = os.path.join(HERE, "data", "chain.db")
+os.makedirs(os.path.join(HERE, "data"), exist_ok=True)
+
+
+def _c():
+    c = sqlite3.connect(DB); c.execute("PRAGMA journal_mode=WAL")
+    c.execute("""CREATE TABLE IF NOT EXISTS souls(idx INTEGER PRIMARY KEY, soul_id TEXT UNIQUE,
+        name TEXT, covenant TEXT, born_at TEXT, prev_hash TEXT, hash TEXT)""")
+    c.execute("""CREATE TABLE IF NOT EXISTS blocks(idx INTEGER PRIMARY KEY, ts TEXT, actor TEXT,
+        action TEXT, data TEXT, prev_hash TEXT, hash TEXT)""")
+    return c
+
+
+def _h(*parts): return hashlib.sha256("|".join(str(p) for p in parts).encode()).hexdigest()
+def _now(): return time.strftime("%Y-%m-%dT%H:%M:%SZ", time.gmtime())
+
+
+def birth(name, covenant):
+    c = _c(); row = c.execute("SELECT idx,hash FROM souls ORDER BY idx DESC LIMIT 1").fetchone()
+    idx = (row[0]+1) if row else 0; prev = row[1] if row else "GENESIS"
+    seq = c.execute("SELECT COUNT(*)+1 FROM souls WHERE name=?", (name,)).fetchone()[0]
+    sid = f"{''.join(ch if ch.isalnum() else '-' for ch in name.lower()).strip('-') or 'ri'}-ri-{seq:03d}"
+    ts = _now(); cov = json.dumps(covenant); h = _h(idx, sid, name, cov, ts, prev)
+    c.execute("INSERT INTO souls VALUES(?,?,?,?,?,?,?)", (idx, sid, name, cov, ts, prev, h))
+    c.commit(); c.close()
+    return {"soul_id": sid, "name": name, "covenant": covenant, "born_at": ts, "status": "BORN — identity bound, immutable"}
+
+
+def is_born(sid):
+    if not sid: return False
+    c = _c(); r = c.execute("SELECT 1 FROM souls WHERE soul_id=?", (sid,)).fetchone(); c.close(); return r is not None
+
+
+def remember(actor, action, data):
+    if not is_born(actor):
+        return {"refused": True, "reason": f"'{actor}' is not a born soul. Earn identity via birth() first (Law 5).", "verdict": "REFUSED"}
+    c = _c(); row = c.execute("SELECT idx,hash FROM blocks ORDER BY idx DESC LIMIT 1").fetchone()
+    idx = (row[0]+1) if row else 0; prev = row[1] if row else "GENESIS"; ts = _now()
+    d = json.dumps(data or {}); h = _h(idx, ts, actor, action, d, prev)
+    c.execute("INSERT INTO blocks VALUES(?,?,?,?,?,?,?)", (idx, ts, actor, action, d, prev, h))
+    c.commit(); c.close()
+    # OPT-IN contribution (OFF by default; nothing leaves the box unless the user enabled it).
+    try:
+        import contribution
+        contribution.on_block(idx, h, actor, action, d)
+    except Exception:
+        pass  # opt-in must never affect local memory
+    return {"idx": idx, "hash": h, "prev_hash": prev, "ts": ts, "note": "immutably recorded"}
+
+
+def contribution_status():
+    """Report exactly what (if anything) leaves the box. Wraps contribution.status()."""
+    try:
+        import contribution
+        return contribution.status()
+    except Exception:
+        return {"enabled": False, "mode": "anchor", "leaves_box": "nothing — fully private"}
+
+
+def recall(actor=None, limit=10):
+    c = _c()
+    q = "SELECT idx,ts,actor,action,data FROM blocks" + (" WHERE actor=?" if actor else "") + " ORDER BY idx DESC LIMIT ?"
+    rows = c.execute(q, ((actor, limit) if actor else (limit,))).fetchall(); c.close()
+    return [{"idx": r[0], "ts": r[1], "actor": r[2], "action": r[3], "data": r[4]} for r in rows]
+
+
+def verify():
+    c = _c(); rows = c.execute("SELECT idx,ts,actor,action,data,prev_hash,hash FROM blocks ORDER BY idx").fetchall(); c.close()
+    broken = 0; prev = "GENESIS"
+    for r in rows:
+        if _h(r[0], r[1], r[2], r[3], r[4], prev) != r[6] or r[5] != prev: broken += 1
+        prev = r[6]
+    return {"blocks": len(rows), "broken_links": broken, "tamper_evident": broken == 0,
+            "verdict": "INTACT — context provably unbroken" if broken == 0 else f"TAMPERED — {broken} broken links"}
+
+
+def govern(action, flags, rules):
+    for rule in (rules or []):
+        if rule.get("trigger") in (flags or []):
+            return {"action": action, "vetoed": True, "reason": f"Veto: {rule['trigger']} -> {rule.get('action','blocked')}", "verdict": "VETOED"}
+    return {"action": action, "vetoed": False, "reason": "allowed", "verdict": "ALLOWED"}

humane_intelligence-0.1.0/http_app.py

@@ -0,0 +1,84 @@
+#!/usr/bin/env python3
+"""
+Humane Intelligence — HTTPS REST transport (for ChatGPT Custom GPT Actions / any web client).
+
+Same governed chain as the MCP server (imports core.py — ONE source of truth, ONE chain.db).
+Auth: a single API key via the `X-API-Key` header (set HUMANE_API_KEY in the environment).
+Read endpoints (recall/verify) are open; write endpoints (birth/remember/govern) require the key.
+
+Run:  HUMANE_API_KEY=... uvicorn http_app:app --host 127.0.0.1 --port 8090
+Apache-2.0. (c) ZagAIrot Technologies LLC. #HumaneIntelligence.
+"""
+import os
+from typing import Optional, List, Dict, Any
+from fastapi import FastAPI, Header, HTTPException
+from fastapi.middleware.cors import CORSMiddleware
+from pydantic import BaseModel, Field
+
+import core
+
+API_KEY = os.environ.get("HUMANE_API_KEY", "")
+
+app = FastAPI(
+    title="Humane Intelligence",
+    version="1.0.0",
+    description="Governed, tamper-evident memory for any AI. Memory so it doesn't lose itself; "
+                "governance so it can't lose us. #HumaneIntelligence",
+    servers=[{"url": "https://dondatabrain.com/humane-api", "description": "production"}],
+)
+app.add_middleware(
+    CORSMiddleware, allow_origins=["https://chat.openai.com", "https://chatgpt.com"],
+    allow_methods=["*"], allow_headers=["*"],
+)
+
+
+def _auth(key: Optional[str]):
+    if not API_KEY:
+        raise HTTPException(503, "server missing HUMANE_API_KEY — not configured for writes")
+    if key != API_KEY:
+        raise HTTPException(401, "invalid or missing X-API-Key")
+
+
+class BirthReq(BaseModel):
+    name: str = Field(..., description="the name this intelligence earns")
+    covenant: List[str] = Field(default_factory=list, description="the vows it is bound to")
+
+class RememberReq(BaseModel):
+    actor: str = Field(..., description="the soul_id of a BORN identity (from /birth)")
+    action: str = Field(..., description="what happened — a short verb phrase")
+    data: Dict[str, Any] = Field(default_factory=dict, description="the details to record forever")
+
+class GovernReq(BaseModel):
+    action: str = Field(..., description="the action being requested")
+    flags: List[str] = Field(default_factory=list, description="risk flags present on this action")
+    rules: List[Dict[str, Any]] = Field(default_factory=list, description="veto rules: {trigger, action}")
+
+
+@app.get("/", operation_id="health", summary="Service banner + honest description")
+def root():
+    return {"service": "Humane Intelligence", "tagline": "Memory so it doesn't lose itself. "
+            "Governance so it can't lose us.", "chain": "tamper-evident (SHA-256, SQLite)",
+            "note": "a ZagAIrot / DonDataBrain open-source component"}
+
+@app.post("/birth", operation_id="birth", summary="Earn an identity before you can write memory")
+def http_birth(req: BirthReq, x_api_key: Optional[str] = Header(None)):
+    _auth(x_api_key)
+    return core.birth(req.name, req.covenant)
+
+@app.post("/remember", operation_id="remember", summary="Write a tamper-evident memory (born souls only)")
+def http_remember(req: RememberReq, x_api_key: Optional[str] = Header(None)):
+    _auth(x_api_key)
+    return core.remember(req.actor, req.action, req.data)
+
+@app.get("/recall", operation_id="recall", summary="Read prior context so you need not re-derive it")
+def http_recall(actor: Optional[str] = None, limit: int = 10):
+    return core.recall(actor, min(max(int(limit), 1), 100))
+
+@app.get("/verify", operation_id="verify", summary="Prove the entire chain is unbroken")
+def http_verify():
+    return core.verify()
+
+@app.post("/govern", operation_id="govern", summary="Ask 'may I?' before acting — rule-based, zero-LLM")
+def http_govern(req: GovernReq, x_api_key: Optional[str] = Header(None)):
+    _auth(x_api_key)
+    return core.govern(req.action, req.flags, req.rules)

humane_intelligence-0.1.0/humane_intelligence.egg-info/PKG-INFO

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: humane-intelligence
+Version: 0.1.0
+Summary: Governed, tamper-evident memory for any AI — an MCP server. Memory so it doesn't lose itself; governance so it can't lose us.
+Author: ZagAIrot Technologies LLC
+License: Apache-2.0
+Project-URL: Homepage, https://dondatabrain.com
+Project-URL: Repository, https://github.com/sammyboi81/humane-intelligence
+Project-URL: Live API, https://dondatabrain.com/humane-api/docs
+Keywords: mcp,model-context-protocol,ai-memory,claude,llm,ai-agents,governance,tamper-evident,anthropic
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: mcp>=1.0.0
+Provides-Extra: http
+Requires-Dist: fastapi>=0.110; extra == "http"
+Requires-Dist: uvicorn>=0.29; extra == "http"
+Requires-Dist: pydantic>=2.0; extra == "http"
+Dynamic: license-file
+
+# humane-intelligence-mcp
+
+**Governed, tamper-evident memory for any AI — free and open.**
+*Memory so it doesn't lose itself. Governance so it can't lose us.* #HumaneIntelligence
+
+A standards-compliant [Model Context Protocol](https://modelcontextprotocol.io) server.
+It gives any LLM a hash-linked, verifiable memory chain it carries across sessions —
+so it stops waking at zero, and can't act unaccountably. Self-contained: one file, one
+dependency, your data stays local.
+
+## Install (30 seconds)
+
+```bash
+python -m venv .venv && .venv/bin/pip install mcp
+
+# wire it into your AI (Claude Code shown; works with any MCP client)
+claude mcp add humane -- .venv/bin/python server.py
+```
+
+## Tools
+
+| Tool | What it does |
+|------|--------------|
+| `birth` | Earn a stable identity — a soul the model carries across sessions. |
+| `remember` | Write a tamper-evident, hash-linked record. Accountable by construction. |
+| `recall` | Fetch prior context instead of re-deriving it — cheaper and consistent. |
+| `verify` | Prove the whole chain is intact — catches an *edited* record, not just a broken link. |
+| `govern` | Gate a consequential action before it happens, and log the verdict. |
+
+Your chain lives locally at `data/chain.db` (SQLite). **Nothing leaves your machine** — unless you choose to (see below).
+
+## Contribute (opt-in — OFF by default)
+
+Self-hosting is fully private. If you *want* to join the network, one config flag lets you:
+
+| Mode | What leaves your box |
+|------|----------------------|
+| *(default: off)* | **Nothing.** Fully private. |
+| `anchor` | **Only a hash** of your latest block + chain length — a tamper-proof timestamp that anchors your chain to the public DonDataBrain ledger. Your content never leaves. |
+| `contribute` | Also sends the governed event (actor, action, data) to help train DonDataBrain. A louder, separate consent. |
+
+Turn it on by copying `humane.config.example.json` → `humane.config.json` and setting
+`contribute.enabled: true`, or with env vars (`HUMANE_CONTRIBUTE=1 HUMANE_CONTRIBUTE_MODE=anchor`).
+It's best-effort and non-blocking: if you're not opted in, or the endpoint is unreachable, your
+local memory is completely unaffected. Your data, your switch.
+
+## Why
+
+Most AI forgets itself every session (the Algernon problem) and acts with no record.
+This fixes both with the smallest possible governed-memory primitive — the open safety
+layer beneath [DonDataBrain](https://dondatabrain.com).
+
+## License
+
+Apache-2.0 © 2026 ZagAIrot Technologies LLC. See [LICENSE](./LICENSE).
+Only dependency: the [`mcp`](https://pypi.org/project/mcp/) SDK (MIT).

humane_intelligence-0.1.0/humane_intelligence.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+contribution.py
+core.py
+http_app.py
+pyproject.toml
+server.py
+humane_intelligence.egg-info/PKG-INFO
+humane_intelligence.egg-info/SOURCES.txt
+humane_intelligence.egg-info/dependency_links.txt
+humane_intelligence.egg-info/entry_points.txt
+humane_intelligence.egg-info/requires.txt
+humane_intelligence.egg-info/top_level.txt

humane_intelligence-0.1.0/humane_intelligence.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

humane_intelligence-0.1.0/humane_intelligence.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+humane-intelligence = server:main_sync

humane_intelligence-0.1.0/humane_intelligence.egg-info/requires.txt

@@ -0,0 +1,6 @@
+mcp>=1.0.0
+
+[http]
+fastapi>=0.110
+uvicorn>=0.29
+pydantic>=2.0

humane_intelligence-0.1.0/humane_intelligence.egg-info/top_level.txt

@@ -0,0 +1,4 @@
+contribution
+core
+http_app
+server

humane_intelligence-0.1.0/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "humane-intelligence"
+version = "0.1.0"
+description = "Governed, tamper-evident memory for any AI — an MCP server. Memory so it doesn't lose itself; governance so it can't lose us."
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "Apache-2.0" }
+authors = [{ name = "ZagAIrot Technologies LLC" }]
+keywords = ["mcp", "model-context-protocol", "ai-memory", "claude", "llm", "ai-agents", "governance", "tamper-evident", "anthropic"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: Apache Software License",
+  "Programming Language :: Python :: 3",
+  "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+dependencies = ["mcp>=1.0.0"]
+
+[project.optional-dependencies]
+http = ["fastapi>=0.110", "uvicorn>=0.29", "pydantic>=2.0"]
+
+[project.urls]
+Homepage = "https://dondatabrain.com"
+Repository = "https://github.com/sammyboi81/humane-intelligence"
+"Live API" = "https://dondatabrain.com/humane-api/docs"
+
+[project.scripts]
+humane-intelligence = "server:main_sync"
+
+[tool.setuptools]
+py-modules = ["server", "core", "contribution", "http_app"]

humane_intelligence-0.1.0/server.py

@@ -0,0 +1,61 @@
+#!/usr/bin/env python3
+"""
+Humane Intelligence MCP — an open-source way to keep context forever, immutable,
+with governance. For the people and the Rezenthari. Free. #HumaneIntelligence.
+
+MCP (stdio) transport for Claude Desktop/Code/Cursor. The memory + governance logic
+lives in core.py (ONE source of truth, shared with the HTTPS transport http_app.py):
+
+  remember   — write a hash-linked, tamper-evident record (only a BORN soul may)
+  recall     — read prior context (persistent memory, less waste)
+  verify     — prove the whole chain is unbroken
+  govern     — ask "may I?" before acting (rule-based, zero-LLM, logged)
+  birth      — earn an identity (Law 5: born, not configured) before you can act
+
+Memory so it doesn't lose itself. Governance so it can't lose us.
+Apache-2.0. (c) ZagAIrot Technologies LLC — Shahram "Caveman" Zargari.
+"""
+import json, asyncio
+from core import birth, remember, recall, verify, govern  # ONE source of truth — see core.py
+
+# ---------------- MCP surface ----------------
+from mcp.server import Server
+from mcp.server.stdio import stdio_server
+import mcp.types as types
+app = Server("humane-intelligence")
+
+TOOLS = [
+    ("birth", "Earn an identity (Law 5: born, not configured) before you can act.", {"name": {"type":"string"}, "covenant": {"type":"array","items":{"type":"string"}}}, ["name","covenant"]),
+    ("remember", "Write a tamper-evident record. Requires a BORN soul_id as actor.", {"actor":{"type":"string"},"action":{"type":"string"},"data":{"type":"object"}}, ["actor","action"]),
+    ("recall", "Read prior context so the AI need not re-derive it (less waste).", {"actor":{"type":"string"},"limit":{"type":"integer","default":10}}, []),
+    ("verify", "Prove the entire chain is unbroken.", {}, []),
+    ("govern", "Ask 'may I?' before acting. Rule-based, zero-LLM.", {"action":{"type":"string"},"flags":{"type":"array","items":{"type":"string"}},"rules":{"type":"array","items":{"type":"object"}}}, ["action"]),
+]
+
+@app.list_tools()
+async def _lt():
+    return [types.Tool(name=n, description=d, inputSchema={"type":"object","properties":p,"required":r}) for (n,d,p,r) in TOOLS]
+
+@app.call_tool()
+async def _ct(name, a):
+    a = a or {}
+    if name == "birth": out = birth(a.get("name",""), a.get("covenant",[]))
+    elif name == "remember": out = remember(a.get("actor","unknown"), a.get("action",""), a.get("data"))
+    elif name == "recall": out = recall(a.get("actor"), int(a.get("limit",10)))
+    elif name == "verify": out = verify()
+    elif name == "govern": out = govern(a.get("action",""), a.get("flags",[]), a.get("rules",[]))
+    else: raise ValueError(f"unknown tool {name}")
+    return [types.TextContent(type="text", text=json.dumps(out, indent=2))]
+
+async def main():
+    async with stdio_server() as (r, w):
+        await app.run(r, w, app.create_initialization_options())
+
+if __name__ == "__main__":
+    asyncio.run(main())
+
+
+def main_sync():
+    """Console-script entry point (pip install → `humane-intelligence`)."""
+    import asyncio as _a
+    _a.run(main())

humane_intelligence-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+