A Decentralized Intelligence Network
"Satoshi gave us money without banks. I will give you brains without corporations." — Kepler
Note from the author
This repository currently contains documentation only. The project is under active, heavy development and needs significant work before a public code release. What is described as "working" in the docs reflects the design targets and progress snapshots from the devnet — it does not mean everything runs perfectly out of the box. Every component is being reworked and improved. I am publishing the architecture and design documents first so that people can understand the vision, the reasoning, and the direction before the code is ready.
The website
synapsenetai.orgis offline at this time.All network statistics, knowledge chain sizes (e.g. ~847 GB), node counts, and similar numbers in the documentation are visualizations of how the system is designed to operate at scale — they are modeled projections, not live metrics from a running public network.
— Kepler
The full project whitepaper (102 pages) covers architecture, consensus design, agent network, Tor integration, and implementation status in detail.
SynapseNet is a decentralized peer-to-peer network for collective intelligence. It is to knowledge what Bitcoin is to money.
Nodes mine intelligence instead of hashes. Contributors feed useful knowledge into an open network, every local AI can draw from it, and the contributors are rewarded with NGT — the native token earned exclusively through protocol activity, never purchased in-protocol.
| Bitcoin | SynapseNet |
|---|---|
| Decentralized currency | Decentralized AI network |
| Mine with hardware | Mine with intelligence |
| Store value | Store knowledge |
| BTC | NGT |
| Proof of Work | Proof of Emergence |
| Blockchain (~850 GB) | Knowledge Chain (design target) |
- Local-first by default — your data stays on your machine unless you choose otherwise
- Cryptography-backed integrity — Ed25519, AES-256-GCM, quantum-resistant key support (CRYSTALS-Dilithium)
- Deterministic consensus — Proof of Emergence (PoE v1) uses deterministic metrics for consensus, not LLM scores
- Privacy boundaries — clear separation between user, device, and network
- No corporate gatekeepers — intelligence belongs to everyone
SynapseNet ships two main binaries:
synapsed — the core node process
C++ daemon handling P2P networking, PoE v1 consensus, NGT ledger, local LLM inference, and optional Web4 search with Tor routing.
synapseide — the terminal IDE client
Go-based coding environment that talks to synapsed over RPC. Features isolated threads (/tangent), unified diff patch mode (/patch), and optional remote model rentals.
KeplerSynapseNet/
include/ Public headers
src/ C++ implementation
main.cpp Node orchestration, RPC, P2P dispatch
network/ Socket layer + peer discovery + sync
infrastructure/ Wire messages and serialization
core/ Ledger, Transfer, Knowledge, PoE v1, Consensus
model/ Model loading / inference / marketplace
web/ Optional Web4 search + Tor + injection
tui/ ncurses UI
tests/ C++ tests (ctest)
crush-main/ SynapseIDE (Go)
The following features have been implemented to varying degrees on the devnet. All of them are actively being reworked and improved — nothing here should be considered stable or production-ready yet.
- Wallet creation (24-word seed) with quantum-resistant keys
- Local GGUF model loading + streaming chat with chunked decode
- Model download with resume, progress panel, and sleep inhibition
- PoE v1 deterministic knowledge: PoW gate → votes → finalize → reward
- PoE v1 code contributions: submit patches, earn NGT after epoch finalize
- Ledger append + block mining/sync (stable on multi-node devnet)
- P2P peer discovery (DNS seeds, peer exchange, network statistics)
- Web 4.0 mode: local agent + optional clearnet/onion context injection
- Terminal Synapse IDE: local completions, isolated threads, patch mode
- VS Code extension: GitHub Quests, chat panel, remote model sessions
- Node-Attached Agent (NAAN): deterministic scheduler + budgets + observatory
- Managed Tor runtime with bridge support across macOS/Linux/Windows
# Build from source
cmake -S KeplerSynapseNet -B KeplerSynapseNet/build -DCMAKE_BUILD_TYPE=Release -DBUILD_TESTS=ON
cmake --build KeplerSynapseNet/build --parallel 8
# Run tests
ctest --test-dir KeplerSynapseNet/build --output-on-failure
# Start the node
TERM=xterm-256color ./KeplerSynapseNet/build/synapsed| Key | Action |
|---|---|
Space |
Continue boot sequence |
1-9 |
Dashboard shortcuts |
0 |
Agent Network observatory |
A |
Attached Agent status |
Tab / F2 |
Model panel |
F4 |
Download model |
F5 |
Toggle web injection |
F6 |
Toggle onion sources |
F7 |
Toggle Tor for clearnet |
I |
Launch Terminal IDE (from code screen) |
PgUp/PgDn |
Scroll chat |
F3 |
Clear chat |
F8 |
Stop generation |
All design documents live in the interfaces txt/ directory. These define the core rules and logic of SynapseNet.
| Document | Description |
|---|---|
| WHAT_IS_SYNAPSENET.txt | Full project overview, philosophy, honest limitations, and comparison to Bitcoin |
| main_interface.txt | Complete UI spec — startup sequence, dashboard, every screen and interaction |
| PROJECT_ARCHITECTURE_SCHEMA.txt | Code-aligned map of runtime subsystems and component responsibilities |
| SYNAPSENET_ARCHITECTURE_VERIFIED_US_EN.txt | Verified architecture snapshot validated against the real repository tree |
| POE_V1_DETERMINISTIC_DESIGN.txt | Proof of Emergence v1 design — deterministic metrics, epochs, rewards |
| PROOF_OF_EMERGENCE_FORMAL_SUPPLEMENT_v1.txt | Formal claim, assumptions, and proof sketch for the PoE whitepaper |
| NODE_ATTACHED_AGENT_NETWORK.txt | NAAN spec — one node, one attached agent, deterministic budgets |
| DARKNET_INTEGRATION_SUMMARY.txt | Tor/onion search module, clearnet routing, managed Tor runtime |
| IMPLANT_AI_STACK_FOR_SYNAPSENET.txt | Future implant-AI stack compatibility design (draft) |
| NEUROCHIP_STACK_FOR_SYNAPSENET.txt | Redirect — renamed to IMPLANT_AI_STACK_FOR_SYNAPSENET.txt |
| NAAN_TOR_BRIDGE_AUTOMATION_CROSS_PLATFORM_TODO.txt | Cross-platform Tor bridge automation TODO (macOS/Linux/Windows) |
| NAAN_TOR_BRIDGE_SETUP_STATUS_AND_SUPPORTED_MODES.txt | Tor runtime modes, bridge setup status, operator workflow |
| V0_2_IMPLEMENTATION_STATUS.txt | v0.2 core implementation status — what is shipped, what is planned |
| V0_2_ATTACHED_AGENT_PRIMARY_UI_SPEC.txt | v0.2 AI Mining (NAAN) primary UI refactor spec |
| V0_2_RUNTIME_UPDATE_IMPLANT_SPEC.txt | v0.2 runtime update/implant minimal spec (implemented baseline) |
| SYNAPSENET_REMEDIATION_TODO_US_EN.txt | Remediation backlog — P0 blockers, P1 hardening, P2 improvements |
| AI.txt | Multi-agent execution board for coordinated development |
No system is perfect. Before you run a node, read this:
- No absolute security — battle-tested crypto, but implementation bugs are possible. Independent audits are needed before mainnet.
- 51% problem applies — if majority of validators collude, they can approve bad knowledge. Same limitation as Bitcoin.
- Consensus is not truth — PoE determines agreement, not objective reality.
- Spam is an arms race — LLM-generated junk is a real threat. Stake, validation, and rate limits raise the cost but don't eliminate it.
- NGT has no guaranteed value — worth depends entirely on network adoption and utility demand.
See CONTRIBUTING.md for guidelines. The short version:
- Fork the repo
- Create a feature branch
- Build and run the test suite
- Submit a PR with a clear description
Code contributions can be submitted as PoE v1 entries (ContentType::CODE) and earn NGT after epoch finalize.
This project is licensed under the MIT License.
MIT License
Copyright (c) 2026 KeplerSynapseNet
