Skip to content

README_CONNECTIVITY.md

Latest commit

 

History

History
69 lines (58 loc) · 2.23 KB

README_CONNECTIVITY.md

File metadata and controls

69 lines (58 loc) · 2.23 KB
Raw

Heady System Connectivity Protocol

1. Local Connectivity

The Heady System operates on two primary nodes locally:

Service Component Port Local URL Binding
Heady Manager Node.js / Express 3300 http://localhost:3300 0.0.0.0 (All Interfaces)
Heady Conductor Python / FastAPI 8000 http://localhost:8000 0.0.0.0 (All Interfaces)

Verification

Run the following to check health locally:

curl http://localhost:3300/api/health
curl http://localhost:8000/api/health

2. Remote Connectivity

Both services are configured to bind to 0.0.0.0, allowing access from other machines on the same network or via tunnels.

Network Access (LAN/VPN)

  • Manager: http://<HOST_IP>:3300
  • Conductor: http://<HOST_IP>:8000

Tunnels (Cloudflare/Ngrok)

To expose services securely to the public internet:

# Example using cloudflared
cloudflared tunnel --url http://localhost:3300

3. Heady Service Structure (Monorepo Compatible)

The system is designed to be modular within a monorepo structure.

/
├── heady-manager.js       # [Manager Node] Orchestrates frontend & MCP
├── src/
│   └── heady_project/     # [Conductor Node] Python Intelligence Core
│       ├── heady_conductor.py  # Entry Point
│       ├── api.py              # FastAPI Interface
│       └── ...
├── frontend/              # [UI Node] React Application
└── hc.cmd                 # [CLI] Unified Command Interface

4. Execution

Start the entire system using the Heady Conductor wrapper:

# Start System (Serve)
./hc.cmd -a hs

# Build System
./hc.cmd -a hb