Deploy with the AMESA Runtime Server

Overview

The AMESA Runtime allows you to run an AMESA agent on your own hardware. It handles receiving observations (sensor data), processing them through the agent, and computing output actions.

The package consists of three components:

• Light Touch Runtime — the core HTTP inference server that loads and runs the agent.

• Client Runtime Proxy — the MQTT bridge that routes observations in and actions out.

• Packaged Agent — the agent model and configuration files (agent.json, etc.).

This guide walks through the full setup process: starting the runtime, and verifying the system is working end-to-end.

Step 1: Start the Light Touch Runtime

The Light Touch Runtime is the inference server. It loads the agent and listens for incoming observations over HTTP.

Set the required environment variables and start the runtime. Run these commands in sequence in your first terminal:

Set Environment Variables

export AMESA_LICENSE= ---- -- ---- --------- --- 
export AMESA_DISABLE_INSTALL_PACKAGES=true 
export AMESA_BASE_DIR=~/packaged_agent 

Launch the Runtime

Point the runtime at the agent configuration file :

~/light_touch_runtime/dist/light_touch_runtime ~/packaged_agent/agent.json 

Expected result: You know this step was successful when you see "Agent Loaded" printed in the terminal. Keep this terminal open — it must stay active for the rest of the process.

Step 2: Start the Client Runtime Proxy

The Client Runtime Proxy handles the MQTT communication layer. It receives observations over MQTT and forwards them to the Light Touch Runtime's HTTP endpoint, then publishes the computed actions back out.

Open a second terminal and run a quick sanity check to confirm the binary is executable:

~/client_runtime_proxy/dist/client_runtime_proxy --agent-id prod-id-agent 

This will return a message saying PID folder missing — that is expected behavior at this stage.

Run the Full Command

~/client_runtime_proxy/dist/client_runtime_proxy \ 
 --agent-id prod-id-agent \ 
 --license usb-token \ 
 --mqtt-broker localhost:1883 \ 
 --mqtt-input-topic amesa/input \ 
 --mqtt-output-topic amesa/output \ 
 --inference-url http://localhost:8080 

Expected result: No PID file found, proceeding with start, followed by a summary of the arguments you passed. This confirms the proxy is running and connected to the runtime.

Step 3: Send a Test Observation

With both terminals running, you can now verify the full pipeline by sending a test observation. This simulates what real sensor data will look like when the system is live.

In your second terminal (or a third if preferred), send the following curl command:

curl -X POST http://localhost:8080/mcp \ 
 -H "Content-Type: application/json" \ 
 -d '{ 
   "jsonrpc": "2.0", 
   "id": 1, 
   "method": "publish", 
   "params": { 
     "channel": "agent.observation", 
     "message": { 
       "observation": [1, 2, 3, 4, 5, 6] 
     } 
   } 
 }' 

Watch your first terminal (where the Light Touch Runtime is running). A successful result will print:

processing observation - 
computed action 

Expected result: If you see both of these messages, the system is fully operational end-to-end.