Quickstart: Run a Worker Node on Your PC
Step-by-step guide to deploying a decentralized worker daemon on Windows, macOS, or Linux in under 60 seconds.
1. System Requirements#
The worker is engineered for minimal resource consumption. The daemon runs silently in the background without straining your CPU or GPU during everyday computing tasks.
| Specification | Minimum Requirement | Recommended |
|---|---|---|
| CPU | 2 Cores (any Intel / AMD / Apple Silicon) | 4+ Cores |
| Memory | 100 MB free RAM | 250 MB RAM |
| Disk Space | 50 MB free disk space | 100 MB |
| Operating System | Windows 10/11, macOS 12+, Ubuntu 20.04+ | Any modern 64-bit OS |
| Runtime | Node.js v18 or higher | Node.js v20 LTS / v22 |
Absolute Security (100% Non-Custodial)
2. Method #1: 1-Click Launcher (Easiest)#
If you prefer not to touch terminal commands, download the pre-packaged launcher for your operating system. The script automatically verifies Node.js and starts the node daemon.
Windows 1-Click Launcher
WINDOWSFor Windows 10 / 11. Simply double-click after downloading.
Linux / macOS Shell Script
LINUXFor macOS and Ubuntu/Debian. Run with: bash senzo-worker.sh
3. Method #2: Launch via Terminal (CLI)#
If you have cloned the repository or are operating within VS Code, PowerShell, or bash, run one of the following commands:
# Option A: From senzo-crypto or senzo-explorer workspace:
npm run node:worker
# Option B: Direct execution via Node.js:
node scripts/senzo-worker.cjs
# Option C: Run as dedicated observer for a specific capsule:
node scripts/senzo-worker.cjs --project my-token-slug4. Expected Terminal Output#
Upon launch, the daemon will benchmark your CPU cores, RAM capacity, and network latency to public TON Liteservers (target benchmark: <35–100 ms).
A high-visibility banner containing your unique claim code will appear in the console:
==============================================================
🚀 SENZO NODE NETWORK (SNN) — COMMUNITY WORKER DAEMON v1.0
==============================================================
🔍 Benchmarking host hardware & network...
• Hardware: 12th Gen Intel Core i5-12400F (12 Cores)
• Memory: 15.8 GB RAM (Free: 9.4 GB)
• Platform: win32 (x64) on DESKTOP-PC
• TON Liteserver Latency: 28 ms (Sub-35ms benchmark passed)
--------------------------------------------------------------
📡 Registering node in Senzo Node Network...
✅ Node registered successfully!
==============================================================
🔑 YOUR CLAIM CODE: SNZ-5PG54A
--------------------------------------------------------------
👉 Open https://senzolab.xyz/app/nodes
👉 Click "Claim Node"
👉 Enter code: SNZ-5PG54A
==============================================================
⏳ Waiting for operator to claim this node... (Heartbeats active)5. Claiming Your Node in Operator Hub#
Copy the generated 6-character claim code (e.g., SNZ-5PG54A).
Navigate to the Operator Hub at https://senzolab.xyz/app/nodes.
Click "Claim Node", paste the code, and give your node a recognizable label (e.g., "Home Ryzen PC").
Immediately upon claiming, you will receive +100 Welcome SNN Points, and your node status will transition to Online.