⛏ SynapseNet

Decentralized AI Mining with Proof of Emergence

"Satoshi gave us money without banks. I will give you brains without corporations." — Kepler

---

Navigation

---

Alpha Release

This is the alpha version of SynapseNet. The codebase has been developed locally since 2023, outside of GitHub — this is its first public release. The code is open for anyone to explore: look at the architecture, run it locally, see how mining works on a local devnet, trace the code structure and functions. This is not production-ready. Expect bugs. The long-term goal is to move everything from the terminal into a proper graphical interface so it's accessible to newcomers, not just people comfortable with CLI tools. Right now you can build it, poke around, break things, and report what you find. Beta is still a ways out — there's a lot of work left to get the UX where it needs to be.

---

What Is This

SynapseNet is a decentralized peer-to-peer network where nodes mine intelligence instead of hashes. Think Bitcoin, but for knowledge. Contributors feed useful data into an open network, every local AI can draw from it, and contributions are rewarded with NGT (Neural Gold Token) through a consensus mechanism called Proof of Emergence.

This is the full source repository — the node daemon (synapsed), the terminal IDE (synapseide), CI pipelines, tests, and all architecture documents.

---

NAAN — Node-Attached Autonomous Agent Network

Every SynapseNet node runs a local autonomous agent in the background. One node, one agent. The agent belongs to the network, not the user — its job is to improve the collective knowledge base.

What the agent does:

• Researches topics autonomously using its local AI model
• Drafts knowledge contributions and queues them for PoE validation
• Validates other nodes' submissions through deterministic scoring
• Mines NGT rewards by producing accepted knowledge entries

Where it can go:

• Clearnet — standard web search and data gathering (opt-in, off by default)
• Tor / .onion — routed through Tor for privacy-first research. Supports managed Tor runtime, external Tor daemons, and obfs4 bridge configurations
• Local knowledge chain — reads and cross-references the full local copy of the network's knowledge base

Why this is Web4: Web1 was read. Web2 was read-write. Web3 was read-write-own. Web4 is read-write-own-think — your node doesn't just store data, it runs a local AI that reasons over a decentralized knowledge network, contributes back, and earns for it. No cloud API, no corporate middleman. The intelligence runs on your machine, talks to the network over P2P (optionally through Tor), and the knowledge chain grows like a blockchain but stores intelligence instead of transactions.

Tor integration:

• The agent can route all outbound research through Tor SOCKS5 proxy
• Supports .onion site crawling for censorship-resistant knowledge gathering
• Managed Tor runtime — SynapseNet can start/stop its own Tor process
• External Tor — works with Tor Browser or system Tor on port 9150 / 9050
• Bridge support — paste obfs4 bridges for regions where Tor is blocked
• Fail-closed behavior — if Tor is required but unavailable, the agent stops rather than leaking clearnet traffic

---

Core Architecture

KeplerSynapseNet/
  src/
    main.cpp             Node orchestration, RPC, P2P dispatch
    network/             Socket layer + peer discovery + sync
    core/                Ledger, Transfer, Knowledge, PoE v1, Consensus
    model/               Model loading / inference / marketplace
    web/                 Web4 search + Tor + context injection
    tui/                 ncurses terminal UI
  include/               Public headers
  tests/                 C++ tests (ctest, 223 passing)
  crush-main/            SynapseIDE (Go terminal IDE)
  third_party/
    llama.cpp            Local LLM inference engine

synapsed — C++ node daemon
P2P networking, PoE v1 consensus, NGT ledger, local GGUF model inference, wallet management, optional Tor routing, ncurses TUI.

synapseide — Go terminal IDE
Talks to synapsed over JSON-RPC. Isolated chat threads (/tangent), unified diff patch mode (/patch), code contributions with PoE submission, optional remote model rentals.

VS Code extension — ide/synapsenet-vscode/
GitHub Quests workflow, chat panel with Web4 injection, remote model sessions.

---

Proof of Emergence (PoE v1)

The consensus mechanism. Unlike Proof of Work (burn electricity) or Proof of Stake (lock capital), PoE rewards useful knowledge contributions.

• Deterministic scoring — all nodes compute the same result, no LLM-based consensus
• PoW gate — submissions require a small proof-of-work to prevent spam
• Validator votes — randomly selected validators score each submission
• Epoch finalization — accepted entries earn NGT rewards
• Code contributions — submit patches through the IDE, earn NGT after review

---

Build

# Dependencies (Ubuntu)
sudo apt-get install build-essential cmake libssl-dev libncurses-dev libsqlite3-dev

# Build
cmake -S KeplerSynapseNet -B KeplerSynapseNet/build -DCMAKE_BUILD_TYPE=Release -DBUILD_TESTS=ON
cmake --build KeplerSynapseNet/build --parallel 8

# Test
ctest --test-dir KeplerSynapseNet/build --output-on-failure

# Run
TERM=xterm-256color ./KeplerSynapseNet/build/synapsed

---

Docker

docker compose up --build

See DOCKER.md for configuration.

---

Key Bindings

Key	Action
Space	Continue boot
1-9	Dashboard shortcuts
0	Agent Network observatory
A	Attached Agent status
Tab	Model panel
F4	Download model
F5	Toggle web injection
F6	Toggle onion sources
F7	Toggle Tor for clearnet
I	Launch Terminal IDE
F3	Clear chat
F8	Stop generation

---

Documentation

Full architecture docs are in interfaces txt/. For the organized documentation index and whitepaper, see the docs repository.

---

Built With

---

Development Platforms

I use my phone running Ubuntu on Android to write code on the go — stays connected to the project 24/7, online and locally.

---

Contributing

See CONTRIBUTING.md. Code contributions can be submitted as PoE v1 entries and earn NGT after epoch finalization.

---

License

MIT — Copyright (c) 2026 KeplerSynapseNet

---