Upload README.md with huggingface_hub

README.md

@@ -0,0 +1,90 @@
+---
+license: mit
+tags:
+  - safetensors
+  - zkaedi-prime
+  - hamiltonian-dynamics
+  - vulnerability-detection
+  - two-field
+  - custom-architecture
+  - security
+  - smart-contracts
+pipeline_tag: other
+---
+
+# 🔱 Leviathan v2 — Two-Field Hamiltonian Classifier
+
+**Session-trained CNN operating on ZKAEDI PRIME two-field (H, V) energy landscapes.**
+
+## Architecture
+
+```
+Input: 2-channel tensor (H_field, V_field)
+  ↓
+Conv2d(2, 16, 3×3) → ReLU
+Conv2d(16, 16, 3×3) → ReLU
+  ↓
+Flatten → 4096
+  ↓
+Linear(4096, 64) → ReLU
+Linear(64, 1) → Output
+```
+
+| Component | Shape | Parameters |
+|-----------|-------|------------|
+| conv_net.0 | (16, 2, 3, 3) + bias | 304 |
+| conv_net.2 | (16, 16, 3, 3) + bias | 2,320 |
+| fc.1 | (64, 4096) + bias | 262,208 |
+| fc.3 | (1, 64) + bias | 65 |
+| **Total** | | **264,897** |
+
+## Usage
+
+```python
+from safetensors.numpy import load_file
+import numpy as np
+
+# Load weights
+weights = load_file("leviathan_v2_session_trained.safetensors")
+
+# Or use the inference module
+from leviathan import Leviathan
+
+model = Leviathan.from_safetensors("leviathan_v2_session_trained.safetensors")
+
+# Input: two-field Hamiltonian snapshot (H, V) as 2-channel image
+H_field = np.random.randn(1, 16, 16)  # Activator field
+V_field = np.random.randn(1, 16, 16)  # Inhibitor field
+input_tensor = np.stack([H_field[0], V_field[0]])[None]  # (1, 2, 16, 16)
+
+output = model.forward(input_tensor)
+print(f"Score: {output}")
+```
+
+## Integration with PRIME Swarm
+
+```python
+from gradio_client import Client
+import json
+
+# 1. Run swarm analysis
+swarm = Client("zkaedi/prime-swarm-hunter")
+result = json.loads(swarm.predict("defi_lending_pool", 300, 150, 42, api_name="/api_preset"))
+
+# 2. Feed energy landscape snapshot to Leviathan for classification
+# Leviathan scores the field state for vulnerability presence
+```
+
+## Part of the ZKAEDI Security Pipeline
+
+```
+Solidity Code
+  → gemma-2-9b-solidity-merged (vulnerability signatures)
+    → prime-swarm-hunter (12-agent temporal detection)
+      → Leviathan v2 (two-field classification)
+        → solidity-vuln-auditor-7b (final audit report)
+```
+
+## Author
+
+**ZKAEDI** — Offensive Healer