qRemoteX — Federated Remote Execution Agent

Lightweight agent that connects to the qRaptor Executor Gateway via WebSocket (QRP protocol) and executes Python scripts and tools on your infrastructure — on-prem, VPC, GPU clusters, or edge.

Install

Gateway URL: Your project's gateway URL is shown in the Studio UI setup wizard. Format: wss://exec-{shortId}.qraptor.app/ws/executor

Docker (Recommended)

docker run -d \
  --name qremotex \
  -e QRAPTOR_GATEWAY_URL=wss://exec-{shortId}.qraptor.app/ws/executor \
  -e QRAPTOR_API_KEY=qrx_prod_... \
  qraptor/qremotex:latest

pip (PyPI)

pip install qremotex

Kubernetes (Helm)

helm install qremotex oci://registry-1.docker.io/qraptor/qremotex \
  --set config.gatewayUrl=wss://exec-{shortId}.qraptor.app/ws/executor \
  --set secrets.apiKey=qrx_prod_...

Run

export QRAPTOR_GATEWAY_URL="wss://exec-{shortId}.qraptor.app/ws/executor"
export QRAPTOR_API_KEY="qrx_prod_..."

qremotex

Or with python -m:

python -m qremotex.main

Configuration (Environment Variables)

Installing Extra Packages

qRemoteX ships with core dependencies only. Add packages your agents need:

# Docker: inline packages
docker run -d \
  -e QRAPTOR_EXTRA_PACKAGES="pandas torch boto3" \
  -e QRAPTOR_GATEWAY_URL=wss://... \
  -e QRAPTOR_API_KEY=qrx_prod_... \
  qraptor/qremotex:latest

# Docker: custom image (recommended for production)
# Dockerfile:
#   FROM qraptor/qremotex:latest
#   USER root
#   RUN pip install --no-cache-dir pandas torch boto3
#   USER qremotex

# pip: install alongside qremotex
pip install qremotex pandas torch boto3

See qRemoteX Documentation for all installation patterns.

Deployment Options

Key Rotation

Rotate keys without restart:

1. Set QRAPTOR_API_KEY_FILE=/path/to/key.txt
2. Write the new key to the file
3. Send kill -HUP <pid> to the agent process

Tests

pip install qremotex[dev]
pytest tests/ -v

Requirements

• Python 3.13+ (for pip install)
• Docker (for container deployment)
• A qRaptor account with an active subscription

Architecture

┌─────────────┐    QRP/WebSocket     ┌──────────────────┐     API      ┌──────────────┐
│  qRemoteX   │◄──────────────────►│  qRaptor Gateway  │◄───────────►│  qRaptor     │
│  (Agent)    │   Heartbeat, Jobs   │  (Edge Router)    │             │  Studio UI   │
│             │   Results, Traces   │                   │             │              │
└──────┬──────┘                     └──────────────────┘             └──────────────┘
       │
       ▼
  Your Infrastructure
  (DB, APIs, GPU, Files)

How it works:

1. qRemoteX connects to the qRaptor Gateway via secure WebSocket
2. The gateway dispatches jobs (Python scripts, tool calls) to the agent
3. The agent executes locally on your infrastructure and streams results back
4. All communication is encrypted (TLS) and authenticated (API key + HMAC)

Learn more at qraptor.ai

License

Proprietary — Copyright © 2026 AugmentAppz. All rights reserved.

Contact: innovate@augmentappz.ai