remote-bench

Run Barretenberg benchmarks on a dedicated remote EC2 machine.

Updated May 14, 2026
One-click install
npx skills add https://github.com/HabibTorjmen/Blockchain --skill remote-bench
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: remote-bench
Source: https://github.com/HabibTorjmen/Blockchain/tree/main/aztec-packages/barretenberg/.claude/skills/remote-bench
Command: npx skills add https://github.com/HabibTorjmen/Blockchain --skill remote-bench

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Producing reliable benchmark numbers is hard when your execution machine is shared or noisy, causing run-to-run variance that makes comparisons untrustworthy.

Core Features & Use Cases

  • Run noise-free EC2 benchmarks: Executes Barretenberg/BB benchmark targets on the dedicated remote benchmarking instance for isolated, publishable single-run results.
  • Safe remote orchestration: Validates required environment variables, enforces a remote lock to prevent concurrent benchmark corruption, transfers the needed binary and inputs, and retrieves benchmark outputs.
  • Workload-agnostic transport: Does not decide what to benchmark; it’s designed to pair with other benchmark skills (e.g., chonk/native/A-B comparison workflows) that define the actual BB command and inputs.

Quick Start

Ask the AI to run the remote benchmark for target bb with the command you intend to measure, after confirming BB_SSH_KEY, BB_SSH_INSTANCE, and BB_SSH_CPP_PATH are configured for the remote machine.

Frequently Asked Questions about remote-bench

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run stable Barretenberg benchmarks without local machine noise?

To run stable Barretenberg benchmarks without noise, execute the targets on a dedicated remote EC2 instance via SSH. This isolates execution to produce reliable, single-run performance measurements for accurate comparisons.

How does remote benchmark execution prevent concurrent run corruption?

Remote benchmark execution prevents concurrent run corruption by validating SSH environment variables and enforcing a remote lock. This lock mechanism blocks simultaneous benchmark processes from interfering with each other on the shared remote machine.

Do I need specific environment variables configured for remote SSH benchmark execution?

Yes, remote SSH benchmark execution requires validated environment variables. You must configure BB_SSH_KEY, BB_SSH_INSTANCE, and BB_SSH_CPP_PATH to enable secure binary transfer, remote execution, and result collection on the EC2 machine.

Can I use remote execution for both native and WASM benchmark targets?

Yes, remote execution supports both native and WASM benchmark targets. The workload-agnostic transport securely transfers the required binary and inputs to the remote machine, retrieves outputs, and applies to remote chonk workloads.

What is the best way to measure performance comparison for Barretenberg targets?

The best way to measure performance comparison for Barretenberg targets is pairing remote execution with other benchmark command skills. This combination defines the actual BB command and inputs while the remote instance ensures noise-free measurements.

Why does my local benchmark run produce unreliable performance comparison numbers?

Local benchmark runs produce unreliable performance comparison numbers due to shared or noisy execution environments causing run-to-run variance. Moving execution to a dedicated remote EC2 machine isolates the workload and yields trustworthy results.