"Everything you see is a result. Every result is a fabric. And every fabric is Arachne."
Arachne is a probabilistic knowledge network framework inspired by quantum mechanics. It models reality as a spiderweb of interconnected nodes (entities) and edges (relationships), where every connection carries a probability—representing uncertainty, causality, and choice.
| Concept | Description |
|---|---|
| Nodes | Entities (people, places, events, ideas) |
| Edges | Relationships with probabilities (0.0 – 1.0) |
| Superposition | Nodes can exist in multiple states simultaneously |
| Collapse | Measurement selects one state from superposition |
| Entanglement | Changes in one node instantly affect another |
| Prediction | Most probable path through the web |
| Learning | Adaptive weights via Bayesian updates |
| Decision Trees | Visualising optimal paths to a target |
- ✅ Graph-based knowledge representation with memory-mapped storage (up to 1M nodes, 5M edges)
- ✅ Quantum-inspired states: superposition, collapse, entanglement
- ✅ Prediction engine for most probable paths
- ✅ Adaptive learning via Bayesian probability updates
- ✅ Batch simulation for sensitivity analysis
- ✅ Decision tree generation for optimal path selection
- ✅ ASCII & SVG visualisations of the network
- ✅ CLI interface with 20+ commands
- ✅ Export to JSON, Graphviz, D3.js
- ✅ Thread-safe with read-write locks
git clone https://github.com/yourusername/arachne.git
cd arachne
make
sudo make install # optional- GCC (or any C99 compiler)
- POSIX-compliant system (Linux, macOS, WSL)
pthreadlibrary (included with most systems)
./arachne [database_name.arachne]add "Israel" 100 # Add node with value
add "Hamas" 85
link 0 1 "conflict" 0.95 # Add edge with probability
show 0 # Display node details
stats # Show network statistics
predict 0 5 # Predict path from node 0 (depth 5)
batch 0 4 "Hamas" 0.30 0.95 0.10 # Sensitivity analysis
decision 1 4 "Peace_Agreement" # Decision tree to target
tree 0 3 # ASCII probability tree
paths 1 "Peace_Agreement" 6 # All paths to target
report 0 5 # Generate text report
debug # Debug all edges
unify # Create Universe root node
export graphviz > graph.dot # Export to Graphviz
export json > graph.json # Export to JSON
quit # Exit./arachne
add "Israel" 100
add "Hamas" 85
add "Peace_Agreement" 10
link 0 1 "conflict" 0.95
link 1 2 "leads_to" 0.70
predict 0 4Output:
🔮 Prediction:
0. "Israel" (1.00)
1. "Hamas" (0.95)
2. "Peace_Agreement" (0.67)
We applied Arachne to ACLED conflict data (2016–2026) to model the Gaza conflict.
- 30+ nodes (countries, organisations, regions)
- 60+ edges (conflict, alliances, mediation)
- Probabilities derived from real event data
The most probable path from Israel leads to:
Israel → Hamas → Escalation → Humanitarian_Crisis → Ceasefire → Peace_Agreement
Probability: 40.7%
Batch simulation showing path changes with different probabilities:
┌─────────────┬─────────────┬──────────────────────────────┐
│ Probability │ Path Length │ First Step │
├─────────────┼─────────────┼──────────────────────────────┤
│ 30% │ 5 │ Gaza_Civilians │
│ 40% │ 5 │ Gaza_Civilians │
│ 50% │ 5 │ Gaza_Civilians │
│ 60% │ 5 │ Hamas │
│ 70% │ 5 │ Hamas │
│ 80% │ 5 │ Hamas │
│ 90% │ 5 │ Hamas │
└─────────────┴─────────────┴──────────────────────────────┘
Critical threshold: ~55% – below this, the path shifts to Gaza_Civilians.
Arachne is named after the Greek myth of Arachne – a weaver who challenged Athena and was turned into a spider. This reflects the project's core idea: everything is a web of probabilities, and whoever holds the threads shapes reality.
- Truth – Is truth just a probability that became real?
- Superposition – Do we exist in multiple states until measured?
- Entanglement – How do our decisions affect others across space and time?
- Imagination – Are alternative realities just probabilities not yet realised?
This paper presents Arachne, a novel framework that models reality as a probabilistic spiderweb of interconnected nodes and edges. Inspired by quantum mechanics—superposition, collapse, and entanglement—Arachne represents entities as nodes and relationships as probabilistic edges. The system supports prediction of most probable paths, adaptive learning from events, decision-tree analysis, and exploration of alternative realities. We demonstrate Arachne on a Middle East conflict network (based on ACLED data), showing how it can model complex geopolitical dynamics and identify critical thresholds for peace. The framework is implemented in C with memory-mapped storage, supporting up to 1M nodes and 5M edges. While not a true quantum system, Arachne offers a practical, extensible model for reasoning about uncertainty, causality, and choice in interconnected systems.
| Feature | Status |
|---|---|
| Core graph engine | ✅ Done |
| Quantum states (superposition, collapse) | ✅ Done |
| Entanglement | ✅ Done |
| Prediction engine | ✅ Done |
| Learning (Bayesian updates) | ✅ Done |
| Batch simulation | ✅ Done |
| Decision trees | ✅ Done |
| ASCII/SVG visualisation | ✅ Done |
| JSON/Graphviz/D3 export | ✅ Done |
Contributions are welcome!
git clone https://github.com/yourusername/arachne.git
cd arachne
make
make testThis project is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License (CC BY-NC-SA 4.0).
You are free to:
- Share – copy and redistribute the material in any medium or format
- Adapt – remix, transform, and build upon the material
Under the following terms:
- Attribution – You must give appropriate credit
- NonCommercial – You may not use the material for commercial purposes
- ShareAlike – If you remix, transform, or build upon the material, you must distribute your contributions under the same license
- Author: EZ-ELDEEN MUSHTAHA
- Email: 3z.eldeen@gmail.com
- GitHub: ezmu
If you find Arachne useful, please:
- ⭐ Star this repository
- 🐛 Report issues
- 🔧 Submit pull requests
- 📖 Cite the paper in your work
"Everything you see is a result. Every result is a fabric. And every fabric is Arachne."
This is reality. This is imagination. This is everything.
🕸️ Arachne v1.0.0 – The Algorithm of Everything