Front Terrain Sovereign Operations

ft-sovx is a production-ready sovereign operations platform designed for deploying and managing autonomous infrastructure nodes. It provides secure, scalable infrastructure for cloud-native applications with built-in billing protection and monitoring capabilities.

1Quick Install (npm)

Install ft-sovx globally using npm (easiest method):

npm install -g ft-sovx

2Prerequisites (For Local Development)

Before installing ft-sovx, ensure you have the following:

• Python 3.8+
• pip (Python package manager)
• Git
• Docker (optional, for containerized deployment)

3Clone the Repository

Get the latest version of ft-sovx from the repository:

git clone https://github.com/ft-sovereign/ft-sovx.git
cd ft-sovx

4Create Virtual Environment

Set up an isolated Python environment:

python -m venv .venv

# On Windows
.venv\Scripts\activate

# On macOS/Linux
source .venv/bin/activate

5Install Dependencies

Install all required packages:

pip install -r ft_sovereign_ops/backend/requirements.txt

6Configure Environment

Set up environment variables for your deployment:

export BACKEND_URL=http://127.0.0.1:8000
export SOVEREIGN_TOKEN=ft_sovereign_secret_handshake_2026
export ENVIRONMENT=development

Using the ft-sovx CLI (npm)

Once installed via npm, use the global ft-sovx command:

-V, --version    output the version number
-h, --help       display help for command

ft-sovx start
Initialize sovereign gateway link node

ft-sovx stop
Isolate and terminate active gateway node

ft-sovx status
Check sovereign node health and network status

ft-sovx setup [options]
Verify and install required Python dependencies

ft-sovx config
Show current deployment configuration

python ft_sovereign_ops/backend/main.py

curl http://127.0.0.1:8000/health

curl -X POST http://127.0.0.1:8000/api/node/start \
  -H "Content-Type: application/json" \
  -H "X-FT-Sovereign-Key: ft_sovereign_secret_handshake_2026"

curl -X POST http://127.0.0.1:8000/api/node/stop \
  -H "Content-Type: application/json" \
  -H "X-FT-Sovereign-Key: ft_sovereign_secret_handshake_2026"

1. Open browser to http://127.0.0.1:8000/dashboard
2. Use "Boot Core Engine" to start operations
3. Monitor telemetry logs in real-time
4. Query diagnostics anytime with "Query Diagnostics"

Development (Local)

For local development, the system automatically uses:

Backend URL: http://127.0.0.1:8000
Environment: development
Billing Protection: Enabled (Smart polling)

Production (Cloud)

For production deployment on serverless infrastructure:

Backend URL: https://api.ft-sovereign.cloud
Environment: production
Auto-routing: Enabled with fallback mechanisms

GET /health

Check if the backend is running and healthy.

Response: 200 OK
{
  "status": "healthy",
  "timestamp": "2026-05-27T10:30:00Z"
}

POST /api/node/start

Boot the sovereign node infrastructure.

Headers:
  X-FT-Sovereign-Key: [token]
  
Response: 200 OK
{
  "message": "Node started successfully",
  "status": "running"
}

POST /api/node/stop

Gracefully stop the node operations.

Headers:
  X-FT-Sovereign-Key: [token]
  
Response: 200 OK
{
  "message": "Node stopped successfully",
  "status": "stopped"
}

Connection Refused

Problem: "Connection refused" error when accessing the backend.

Solution: Ensure the backend server is running with python ft_sovereign_ops/backend/main.py

Authentication Failed

Problem: "401 Unauthorized" error on API calls.

Solution: Verify the X-FT-Sovereign-Key header matches the configured token exactly.

Port Already in Use

Problem: Port 8000 is already in use.

Solution: Kill the process or run on a different port:

python ft_sovereign_ops/backend/main.py --port 8001

Billing Protection Not Active

Problem: Health checks are still running when tab is hidden.

Solution: Ensure you're using an updated browser that supports the Visibility API.

Once you've installed and configured ft-sovx, you can:

• Access the interactive Sovereign Dashboard for visual control
• Deploy to production using Docker and serverless infrastructure
• Configure custom telemetry and monitoring
• Integrate with existing infrastructure
• Scale to multiple nodes for enterprise deployments