Upload README.md with huggingface_hub
Browse files
README.md
CHANGED
|
@@ -1,13 +1,68 @@
|
|
| 1 |
---
|
| 2 |
-
title: Membra
|
| 3 |
-
emoji:
|
| 4 |
-
colorFrom:
|
| 5 |
-
colorTo:
|
| 6 |
sdk: gradio
|
| 7 |
-
sdk_version:
|
| 8 |
-
python_version: '3.13'
|
| 9 |
app_file: app.py
|
| 10 |
pinned: false
|
|
|
|
| 11 |
---
|
| 12 |
|
| 13 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
---
|
| 2 |
+
title: Membra DAG VM
|
| 3 |
+
emoji: 🧠
|
| 4 |
+
colorFrom: gray
|
| 5 |
+
colorTo: blue
|
| 6 |
sdk: gradio
|
| 7 |
+
sdk_version: 4.0.0
|
|
|
|
| 8 |
app_file: app.py
|
| 9 |
pinned: false
|
| 10 |
+
python_version: "3.11"
|
| 11 |
---
|
| 12 |
|
| 13 |
+
# Membra DAG VM
|
| 14 |
+
|
| 15 |
+
Deterministic execution engine for autonomous agent workflows.
|
| 16 |
+
|
| 17 |
+
## Features
|
| 18 |
+
|
| 19 |
+
- **Zero API Keys** — Fully self-contained, no external API calls
|
| 20 |
+
- **Deterministic** — Same input produces same execution trace (when seeded)
|
| 21 |
+
- **Verifiable Receipts** — SHA-256 hash chain + signed receipts
|
| 22 |
+
- **DAG Native** — Directed Acyclic Graph execution with dependency resolution
|
| 23 |
+
- **8 Opcode VM** — LOAD_SOURCE → ASSERT_POLICY → RETRIEVE → TRANSFORM → EXECUTE_SKILL → VERIFY → COMMIT_RECEIPT → HALT
|
| 24 |
+
|
| 25 |
+
## Architecture
|
| 26 |
+
|
| 27 |
+
| Layer | Component | Status |
|
| 28 |
+
|-------|-----------|--------|
|
| 29 |
+
| A | BitNet Proof Kernel | ✅ Operational |
|
| 30 |
+
| B | Cognition DAG | ✅ Operational |
|
| 31 |
+
| C | WASM Worker Runtime | ⚠️ Partial (Python fallback) |
|
| 32 |
+
| D | Coordinator / Nervous System | ✅ Operational |
|
| 33 |
+
| E | Semantic Runtime | 🔄 Memory/lineage only |
|
| 34 |
+
| F | Settlement | ⚠️ Simulated |
|
| 35 |
+
|
| 36 |
+
## Usage
|
| 37 |
+
|
| 38 |
+
1. Enter an **objective** (e.g., "Analyze sentiment of customer reviews")
|
| 39 |
+
2. Toggle **Deterministic Mode** (recommended)
|
| 40 |
+
3. Click **Execute DAG**
|
| 41 |
+
4. View the execution log and verifiable receipt
|
| 42 |
+
|
| 43 |
+
## Receipt Format
|
| 44 |
+
|
| 45 |
+
Each completed run produces a receipt:
|
| 46 |
+
|
| 47 |
+
```json
|
| 48 |
+
{
|
| 49 |
+
"id": "rcpt-...",
|
| 50 |
+
"run_id": "run-...",
|
| 51 |
+
"objective": "...",
|
| 52 |
+
"node_count": 8,
|
| 53 |
+
"completed_count": 8,
|
| 54 |
+
"hash_chain": "sha256-of-all-node-hashes",
|
| 55 |
+
"signature": "deterministic-signature",
|
| 56 |
+
"created_at": "2024-..."
|
| 57 |
+
}
|
| 58 |
+
```
|
| 59 |
+
|
| 60 |
+
## No Secrets Required
|
| 61 |
+
|
| 62 |
+
This Space runs entirely offline:
|
| 63 |
+
- No LLM API keys (Groq, OpenAI, etc.)
|
| 64 |
+
- No blockchain keys
|
| 65 |
+
- No database connections
|
| 66 |
+
- No external HTTP calls
|
| 67 |
+
|
| 68 |
+
All computation is deterministic mock execution for demonstration and testing of the DAG VM architecture.
|