offload

Distribute and execute tests in parallel across local and Modal sandboxes.

132|5|Updated Jan 21, 2026
One-click install
npx skills add https://github.com/imbue-ai/offload --skill offload
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: offload
Source: https://github.com/imbue-ai/offload/tree/main/skills/offload
Command: npx skills add https://github.com/imbue-ai/offload --skill offload

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Offload enables rapid, scalable test execution by distributing tests across multiple sandboxes (local processes or remote Modal environments), reducing overall run time and improving resource utilization.

Core Features & Use Cases

  • Parallel test execution across sandboxes (local and Modal)
  • Pluggable providers and support for multiple frameworks (pytest, cargo nextest, vitest, and custom runners)
  • Built-in retry mechanics for flaky tests, log filtering, and debugging assistance
  • Config-driven scheduling and grouping to optimize test queues

Quick Start

Run offload in the project root to distribute tests across sandboxes using your offload.toml configuration.

Frequently Asked Questions about offload

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

FAQPage Schema
How do I run pytest tests in parallel across remote sandboxes?

You can distribute and execute pytest tests in parallel across local processes and remote Modal sandboxes to accelerate test runs by configuring your offload.toml file.

What is the best way to handle flaky tests in a parallel test execution environment?

You can handle flaky tests in parallel execution environments using built-in retry mechanics, log filtering, and debugging assistance to manage test suite reliability.

Can I use offload with custom test runners and Makefile wrappers?

Yes, you can execute tests with custom runners and project wrappers like Makefile, justfile, or offload.toml, supported by pluggable providers for pytest, cargo nextest, and vitest.

Does parallel test execution support cost estimation and environment variables?

Yes, parallel test execution supports cost estimation, environment variables, collection mode, copying directories, and related flags for parallelism across Modal environments and local processes.

How do I configure test grouping and scheduling for complex test suites?

You can configure test grouping and scheduling for complex test suites using config-driven scheduling in your offload.toml file to optimize test queues distributed across multiple sandboxes.