SuperBrain is a privacy-first, decentralized AI knowledge network where:
- Your AI runs locally on your device — nothing leaves your machine by default
- You earn TAO (Bittensor's cryptocurrency) by sharing quality knowledge to the network
- Knowledge is verified with Ed25519 signatures and synced via I2P (anonymous routing)
- Phase 2 routing: queries are classified and sent to the best Bittensor subnet (SN442 knowledge, SN64 code, SN18 vision)
- No central server controls the data — you own your knowledge
| Platform | Download | Notes |
|---|---|---|
| Linux | AppImage | chmod +x *.AppImage && ./*.AppImage --no-sandbox |
| Mac | DMG | Intel + Apple Silicon |
| Windows | Installer | NSIS setup wizard |
Builds are automated via GitHub Actions on every release tag (
git tag v1.0.0 && git push --tags).
git clone https://github.com/KatchDaVizion/superbrain-desktop-work.git
cd superbrain-desktop-work
npm install --legacy-peer-deps
npm run vite:build:app
npx electron-builder --linux AppImage --publish never
# AppImage output in dist/curl -fsSL https://ollama.com/install.sh | sh
ollama pull qwen2.5:0.5bdocker run -d --name superbrain-qdrant -p 6333:6333 --restart unless-stopped qdrant/qdrant| Feature | Description |
|---|---|
| AI Chat | Chat with AI privately. Voice input/output. Answers routed to best subnet. |
| My Knowledge | Private vault for knowledge chunks + conversations. Share selectively to earn TAO. |
| RAG Chat | Upload documents (PDF, text) and ask questions about them. Uses Qdrant vector DB. |
| Network Knowledge | Search the collective knowledge pool across all nodes. |
| Node Map | 3D rotating brain visualization of the live network with real-time peer data. |
| Wallets | Manage Bittensor hotkeys. Track TAO balance and earnings. |
| Guide | 10-section walkthrough: privacy, earning TAO, miner registration, Docker setup. |
| Phase 2 Routing | Queries classified and routed: SN442 (knowledge), SN64 (code), SN18 (vision). |
| Voice | Speech-to-text input + text-to-speech output. Hands-free mode. |
| Onboarding | 4-step setup or skip straight to using the app. |
Desktop App (Electron + React + TypeScript)
├── app/pages/ # 11 pages (Home, Chat, Knowledge, Map, Guide, Wallets...)
├── app/hooks/ # useOllama, useVoice, useNetworkRAG, useChatManager
├── app/services/ # knowledgeVault, nodeConfig, peerDiscovery, poolAPI
├── app/components/ # DashboardLayout, sidebar, chat UI, DockerSetupBanner
├── lib/main/ # Electron main process (Qdrant auto-start, Docker check)
└── lib/bittensor/ # Wallet management, mining, subnet metrics
Seed Node API
├── /query # Knowledge pool RAG — answers questions
├── /route # Phase 2 routing — classifies + calls SN64/SN18
├── /peers # Peer registry — live peer list with lat/lon
├── /announce # Peer discovery — nodes register themselves
├── /knowledge/add # Share knowledge to the network
└── /chunks # Knowledge pool stats
Sync Protocol (5-step delta sync)
├── LAN (mDNS) # Local network auto-discovery
├── Bluetooth RFCOMM # Offline peer-to-peer
└── I2P SAM v3.1 # Anonymous internet sync
- Share quality knowledge via My Knowledge or RAG Chat
- Validators score every chunk automatically (every ~5 seconds):
- Supportedness (40%) — Does it support accurate answers?
- Relevance (25%) — Does it match what people ask?
- Novelty (20%) — Is it unique? Duplicates score zero.
- Latency (15%) — How fast does your node respond?
- TAO flows to your hotkey wallet automatically
pip install bittensor
btcli wallet new_hotkey --wallet.name my_wallet
btcli subnet register --netuid 442 --subtensor.network test --wallet.name my_walletThe seed node IP is the public SuperBrain network entry point. To add your own seed node:
// app/services/nodeConfig.ts
seed_nodes: [
'http://46.225.114.202:8400', // SuperBrain seed (Frankfurt)
'http://YOUR_SERVER:8400', // Your seed node
],- Private by default: Knowledge stays on your device unless you explicitly share it
- Sharing is permanent: Once shared, knowledge is copied to peer nodes and cannot be deleted
- Ed25519 signatures: Every shared chunk is cryptographically signed
- I2P transport: Anonymous sync — your IP is never exposed
- No tracking: No analytics, no telemetry, no data collection
- Frontend: React 19, TypeScript, Tailwind CSS, Lucide icons
- Desktop: Electron 36, electron-vite, electron-builder
- AI: Ollama (local inference), Qdrant (vector DB), Web Speech API (voice)
- Blockchain: Bittensor SDK, Yuma Consensus (SN442)
- Sync: I2P SAM v3.1, mDNS (LAN), Bluetooth RFCOMM
- Server: FastAPI, PM2, Nginx
- Fork the repo
- Create a feature branch:
git checkout -b feature/my-feature - Run dev server:
npm run dev - Build and test:
npm run vite:build:app - Submit a pull request
MIT License — see LICENSE for details.
Built by KatchDaVizion on Bittensor Subnet 442.