superhq-ai

superhq-ai / shuru

Public

A local-first microVM sandbox for running AI agents safely on macOS

shuru.run
491
8
100% credibility
Found Feb 23, 2026 at 382 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Rust
AI Summary

Shuru creates disposable Linux sandboxes on Apple Silicon Macs for safely executing code, ideal for AI agents.

How It Works

1
🔍 Discover Shuru

You hear about Shuru, a safe playground on your Mac for testing code without any mess or risks.

2
📥 Get it set up

Run one easy command to download and install everything you need.

3
🚀 Start your first session

Type a simple command like 'shuru run' and step into a fresh, clean space ready for action.

4
🛡️ Run code safely

Execute scripts, install tools, or test ideas – everything resets automatically, keeping your Mac untouched.

5
Choose your path
⚡
Quick test

Run one-off commands with optional internet access.

💾
Save setup

Create snapshots to reuse environments later.

6
🌐 Connect the world

Forward ports to access services inside your playground from your Mac.

✅ Perfect sandbox

Your AI helpers now run securely, experimenting freely without worries.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 382 to 491 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is shuru?

Shuru is a Rust-built local-first microVM sandbox for running AI agents safely on macOS Apple Silicon. It launches ephemeral Alpine Linux VMs via Apple's Virtualization framework, auto-resetting the root filesystem after each run to isolate code execution, package installs, and tools from your host. CLI commands like `shuru run -- python script.py` or `shuru checkpoint create py -- apk add python3` make it dead simple for local-first GitHub agent workflows.

Why is it gaining traction?

Stands out with vsock port forwarding (`shuru run -p 8080:80 -- nginx`) that proxies host ports to guest services without full network exposure—safer than Docker for untrusted agents. Checkpoints let you snapshot environments (e.g., pre-install numpy), booting in seconds versus minutes for heavier VMs. Devs dig the zero-config NAT toggle and Rust efficiency for microVM overhead.

Who should use this?

macOS devs prototyping AI agents—like tool-calling bots, local RAG chains, or code-executing LLMs—that need sandboxed execution without cloud dependencies. Perfect for Rust enthusiasts testing local-first agents safely, or teams avoiding Docker escapes in agentic pipelines.

Verdict

Worth installing for Apple Silicon users needing quick agent sandboxes—CLI shines, but 156 stars and 1.0% credibility signal early days; expect bugs, file issues actively. Solid beta for experiments, pair with checkpoints for reuse.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.