Orchestrate scripts
across any node.
A lightweight agent-controller framework that lets you securely trigger and manage scripts across a distributed mesh of remote agents — no SSH required.
$ scriptmesh run --agent NODE_1 --script nightly_backup
Resolving agent NODE_1...
✓ Agent online — 192.168.1.42:8001
✓ Script whitelisted in manifest
✓ Authenticated via Fernet-encrypted key
▶ Executing nightly_backup.py...
✓ Script completed successfully in 1.24s
Everything you need to orchestrate at scale
ScriptMesh gives you the primitives for secure, observable script execution without the complexity of traditional remote management tools.
Remote Script Execution
Trigger scripts on any remote node via a clean HTTP API. No SSH, no shared storage — just secure, auditable HTTP calls.
Manifest-Based Security
Every agent maintains a script manifest that whitelists exactly which scripts can execute. Unauthorized scripts are silently rejected.
Agent Auto-Discovery
Agents self-register with the orchestrator on startup using hostname-based naming. Zero manual provisioning required.
Health Monitoring
Automatic heartbeat checks run every minute, tracking agent availability and execution status across your entire mesh.
Fernet Encryption
API keys are encrypted at rest using Fernet symmetric encryption. Each agent gets a unique key with isolated rotation.
Zero-Friction Deployment
The orchestrator ships as a Docker Compose stack. Agents run as a single Python process or systemd service.
Up and running in three steps
Deploy the Orchestrator
Spin up the central orchestrator with a single Docker Compose command.
$ docker compose up --build -d
Register Your Agents
Start the agent on each remote node. It auto-registers and generates its script manifest.
$ python agent.py
Execute Scripts
Trigger scripts on any agent through the REST API or controller CLI.
$ curl -X POST /run-script -H "x-api-key: $KEY"
Three-component design for maximum control
The orchestrator acts as your central control plane. Agents run on remote nodes and only execute whitelisted scripts. The controller CLI lets you issue commands from anywhere in your network.
- Orchestrator — Central FastAPI service that manages agent registration, routing, and health checks.
- Agents — Lightweight servers on each remote node. They execute scripts and report status back.
- Controller CLI — Your command-line interface for issuing run commands across the mesh.
Built in the open
ScriptMesh is open source. Inspect every line of code, run it yourself, contribute back, or build your own integrations on top of the core framework.
Ready to run your first remote script?
Get started for free with the self-hosted open source version, or upgrade to Pro for managed cloud hosting and advanced features.