Connect apps and AI agents to physical devices

# pip install nexalware nexalware-agent
from nexalware import Client
from nexalware.agent import Agent, tool

client = Client(api_key="nxw_sk_...")

@tool(description="Run a command on a device")
def run_command(device_id: str, command: str) -> str:
    return client.devices.get(device_id).command(command)

agent = Agent(model="production-agent-v1", tools=[run_command])

# Reasons over live telemetry, decides, and acts
for event in client.devices.stream():
    if event.metric == "moisture" and event.value < 30:
        agent.run(f"{event.device_id} moisture is low.")

# Send a command to a device over the REST API
curl -X POST "$NEXALWARE_API/api/v1/devices/pump-003/command" \
  -H "Authorization: Bearer $NEXALWARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cmd": "pump.start", "params": {"minutes": 10}}'

# Follow live device state over WebSocket
wscat -c "$NEXALWARE_WS/api/v1/ws" \
  -H "Authorization: Bearer $NEXALWARE_API_KEY"

{
  "jsonrpc": "2.0",
  "id": 7,
  "method": "tools/call",
  "params": {
    "name": "run_command",
    "arguments": {
      "device_id": "pump-003",
      "command": "pump.start"
    }
  }
}