OBrain Sovereign Engine
Engineering

Private Node Setup

Step-by-step guide to deploy your Sovereign Engine node

Private Node Setup 🚀

This guide provides the technical steps to deploy a Sovereign Node and link it to the global Cloudflare Edge orchestrator.

1. Environment Preparation

Ensure your hardware meets the Requirements.

# Clone the private infrastructure repository
git clone https://github.com/eusheriff/OBrainOconnector.git
cd OBrainOconnector/local-engine

# Setup Python Virtual Environment
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

# Install Playwright dependencies
playwright install --with-deps chromium

2. Security Handshake Configuration

Create a .env file in local-engine/ with your node credentials provided by the master orchestrator.

EDGE_ORCHESTRATOR_URL=https://api.oconnector.tech
NODE_SECRET_KEY=your_hmac_secret_here
MAX_CONCURRENT_THREADS=10

3. Network Connectivity (Invisibility)

To keep your node "Sovereign" and its IP hidden, we use Cloudflare Tunnel.

  1. Install cloudflared on your local machine.
  2. Authenticate: cloudflared tunnel login.
  3. Route your local FastAPI server (default port 8000) through the tunnel.

4. Initializing the Engine

Launch the main dispatcher to start receiving signals from the Edge.

python src/main.py

5. Verification

Check the Audit Trail in your Institutional Dashboard to confirm the node is "Active" and the HMAC handshake is passing.


Troubleshooting

  • HMAC Mismatch: Ensure your system clock is synced via NTP.
  • Vision Timeout: Check if another process is consuming GPU/Neural Engine resources.

On this page