# Easyremote Remote Agent

> Build low-boilerplate remote agent capabilities with EasyRemote using RemoteSkill, pipeline export/import, and streaming media/voice payloads. Use when an agent needs to register remote functions in a few lines, share them across devices, or consume remote stream outputs safely with gateway/node pressure controls. Use when this capability is needed.

- Skill: `tomevault-io/easyremote-remote-agent` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/easyremote-remote-agent`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/easyremote-remote-agent/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/easyremote-remote-agent

---


# EasyRemote Remote Agent Skill

Use this skill to package remote capabilities for agent reuse with minimal config.

## Build Capability Set

1. Create one `RemoteSkill` with gateway and namespace.
2. Register capabilities with `@skill.remote`, `@skill.media`, or `@skill.voice`.
3. Keep function bodies minimal; real execution is delegated to remote functions.

```python
from easyremote import RemoteSkill

skill = RemoteSkill(
    name="voice-agent",
    gateway_address="your-vps-ip:8080",
    namespace="assistant",
)

@skill.voice(name="transcribe_live", timeout=30)
def transcribe_live(audio):
    return audio

@skill.media(name="stream_frames", media_type="video/h264", stream=True, timeout=60)
def stream_frames(source):
    return source
```

## Share Across Devices

1. Export pipeline JSON from source device.
2. Transfer payload through queue/file/RPC.
3. Rebuild callable pipeline on target device.

```python
from easyremote import pipeline_function

pipeline_json = skill.export_pipeline(include_gateway=True)
remote_pipe = pipeline_function(pipeline_json)

print(remote_pipe.capabilities())
result = remote_pipe("transcribe_live", b"pcm16-bytes")
for chunk in remote_pipe("stream_frames", "camera://lobby"):
    print(chunk)
```

## User-Side Agent Service Install

Use `RemoteAgentService` when user software should install new skills at runtime.

```python
from easyremote import RemoteAgentService

service = RemoteAgentService(
    user_id="alice",
    preferred_language="zh-CN",
    gateway_address="your-vps-ip:8080",
)

service.install_skill(pipeline_json)  # pushed by remote agent
result = service.run_any("transcribe_live", b"pcm16-bytes")
```

## Install Device Abilities at Runtime (Camera/Video)

Use `UserDeviceCapabilityHost` when remote agent needs to add local hardware abilities.

```python
from easyremote import UserDeviceCapabilityHost

host = UserDeviceCapabilityHost(node)  # node = user-side ComputeNode
host.register_action("camera.take_photo", take_photo)
host.register_action("camera.record_video", record_video)

# capability metadata must include device_action mapping
host.install_skill(camera_skill_payload)
```

## Voice and Media Framing

Use `stream_audio_pcm` to chunk PCM bytes for low-latency voice flows.

```python
from easyremote import stream_audio_pcm

frames = list(stream_audio_pcm(pcm_bytes, frame_bytes=3200, sample_rate_hz=16000, channels=1))
```

Pass frames as regular function inputs when remote capability expects framed payload.

## Pressure Controls (Required for Production)

Apply limits on gateway and node to avoid stream overload.

```python
from easyremote import Server
from easyremote.core.nodes.compute_node import NodeConfiguration, ComputeNode

server = Server(
    port=8080,
    max_total_active_streams=512,
    max_streams_per_node=32,
    stream_response_queue_size=256,
)

config = NodeConfiguration(
    gateway_address="your-vps-ip:8080",
    node_id="node-a",
    max_concurrent_executions=8,
    queue_size_limit=512,
)
node = ComputeNode(gateway_address=config.gateway_address, node_id=config.node_id, config=config)
```

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/easyremote) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->