Deploy to the fleet in a few lines.
Nodes join with the stand-alone node agent; your code installs a verified
agent from the marketplace, or deploys one directly. Either way it is
scheduled, kept warm, reaped, and restarted for you.
node agent: python3 scripts/node_agent.py
state: SQLite, cross-process
marketplace: Ed25519-signed installs
from terrabox_sdk import TerraboxClient
client = TerraboxClient("https://api.terrabox.example", api_key="tbx_live_...")
# a host joins the fleet (usually run as scripts/node_agent.py on the box):
# POST /api/v1/fleet/nodes/register -> node_id, then heartbeat on interval
# install a SIGNED agent from the marketplace and deploy it, fleet-managed
client.marketplace_install(
"fraud-detector", tenant_id,
require_signed=True, # refuse unsigned / untrusted publishers
deploy=True,
)
# ...or deploy directly: scheduled, warm-started, reaped when idle, restarted on failure
agent = client.deploy_managed_agent(
tenant_id, name="fraud-prod",
template="python",
confidential=True, # place inside an attested TDX node
idle_timeout_seconds=900,
restart_policy="on_failure",
)
client.control_stats() # phase counts, warm pools, live capacity
client.fleet_capacity() # free vCPU / memory / slots across the fleet
client.terminate_managed_agent(agent["agent_id"])