zeptoclaw is a free, open source ai interaction & interfaces project written in Rust and released under Apache-2.0. It has 652 GitHub stars, 98 forks and 54 open issues, and was last pushed 3 days ago. On this registry it ranks #144 of 156 tracked projects in AI Interaction & Interfaces, with 5 head-to-head comparisons available.

What is zeptoclaw?

ZeptoClaw is a fast, small, secure, local-first personal AI assistant infrastructure delivered as one Rust binary that bundles tools, memory, channels, providers, and sandboxed autonomy for running personal AI agents locally, at the edge, or on a VPS.

What it is

ZeptoClaw is an open-source personal AI assistant infrastructure written in Rust and licensed under Apache-2.0. It ships as a single binary that includes tool execution, long-term memory, channel integrations, multi-provider LLM support, and sandboxed autonomy, allowing users to run AI agents on their own hardware. The project lives in AI & Machine Learning / AI Interaction & Interfaces, has 653 stars and 98 forks, and is distributed through https://zeptoclaw.com/.

ZeptoClaw solves the tradeoffs of existing personal AI assistants. OpenClaw offers broad integrations but carries a large TypeScript app footprint; NanoClaw provides container isolation but narrows to a tiny assistant core; NemoClaw supplies OpenShell guardrails but requires a Docker/k3s footprint with a ~2.4GB sandbox image; PicoClaw achieves edge efficiency in Go but lacks Rust's safety controls. ZeptoClaw replaces these fragmented choices with a single 6MB Rust binary that starts in 50ms, uses 6MB of RAM, and ships with container isolation, prompt injection detection, and a circuit breaker provider stack.

Key capabilities

  • Multi-provider LLM support for 18 providers, including Anthropic, OpenAI, OpenRouter, Google Gemini, Google Vertex AI, Groq, DeepSeek, xAI (Grok), NVIDIA NIM, Azure OpenAI, AWS Bedrock, Kimi (Moonshot), Zhipu (GLM), Qianfan (Baidu), Novita AI, Liquid AI, Ollama, and VLLM, with SSE streaming, retry with backoff and budget cap, and auto-failover.
  • 33 built-in tools and plugins covering shell, filesystem, grep, find, web, git, stripe, PDF, transcription, and Android ADB.
  • Tool composition from natural language descriptions using composable {{param}} templates.
  • Configuration through ~/.zeptoclaw/config.json or environment variables such as ZEPTOCLAW_PROVIDERS_GROQ_API_KEY, with api_base overrides.
  • Sandboxed autonomy, container isolation, prompt injection detection, and a circuit breaker provider stack.
  • Streaming agent command zeptoclaw agent --stream -m "..." that can fetch web content, run shell commands, and store findings in long-term memory.
  • Single 6MB Rust binary that starts in 50ms and uses 6MB of RAM.

Who uses it and how

  • Individuals and small teams running personal AI agents locally, at the edge, or on a VPS, using the installation script and zeptoclaw onboard.
  • Edge deployments where low footprint matters, supported by the 6MB binary size, 50ms startup, and 6MB RAM usage.
  • Security-conscious users who need sandboxed autonomy, prompt injection detection, and container isolation.
  • Developers integrating multiple LLM providers, including local Ollama and VLLM endpoints, who require failover and budget caps.
  • Users automating technical tasks such as API security analysis, where zeptoclaw agent --stream -m "Analyze our API for security issues" fetched API docs, ran integration tests, and stored findings in long-term memory under "api-audit".

Getting started

Install ZeptoClaw on any VPS with curl -fsSL https://zeptoclaw.com/setup.sh | bash, which installs the binary and prints next steps. Run zeptoclaw onboard to configure providers and channels, or edit ~/.zeptoclaw/config.json and set environment variables directly.

How it compares

ZeptoClaw positions itself among similar tools named in its documentation: OpenClaw, NemoClaw, NanoClaw, and PicoClaw. It aims to combine OpenClaw's integrations, NemoClaw's guardrails, NanoClaw's container isolation, and PicoClaw's edge efficiency without their respective tradeoffs, offering a single Rust binary instead of a large TypeScript app, a Docker/k3s footprint, a narrow assistant core, or a Go-only edge focus.

When to use it — and when not to

Choose ZeptoClaw when a self-hosted, local-first personal AI assistant with a small footprint, multi-provider support, and built-in security features fits the workload, and when running and updating a binary on a VPS or edge device is acceptable. Avoid it if a fully managed service is required or if the existing 33 tools and 18 providers do not cover needed integrations, since the supplied README is sparse on memory, channel, and sandbox implementation details. The project has 54 open issues and active development up to its last push in September 2026, so review those issues before production use.

project readme (upstream, from github) — read inline

ZeptoClaw

Fast, small, secure, and local-first personal AI assistant infrastructure.

Documentation

Release License


$ zeptoclaw agent --stream -m "Analyze our API for security issues"

🤖 ZeptoClaw — Streaming analysis...

  [web_fetch]        Fetching API docs...
  [shell]            Running integration tests...
  [longterm_memory]  Storing findings...

→ Found 12 endpoints, 3 missing auth headers, 1 open redirect
→ Saved findings to long-term memory under "api-audit"

✓ Analysis complete in 4.2s

ZeptoClaw is one Rust binary for running personal AI agents locally, at the edge, or on a VPS — with tools, memory, channels, providers, and sandboxed autonomy built in. We studied the best AI assistants — and their tradeoffs: OpenClaw's integrations without the large TypeScript app footprint, NanoClaw's container-isolated simplicity without narrowing to a tiny assistant core, NemoClaw's OpenShell guardrails without the Docker/k3s footprint, and PicoClaw's edge efficiency with Rust's safety and runtime controls.

~6MB binary ~50ms startup ~6MB RAM 3,900+ tests 18 providers

Why ZeptoClaw

We studied what works — and what doesn't.

OpenClaw proved a personal AI assistant can grow into a broad integration and skills ecosystem. NanoClaw proved container isolation can be simple enough to understand and customize. NemoClaw proved managed guardrails matter — policy-gated sandboxes, routed inference, credential injection, channel messaging, and digest-verified blueprints. PicoClaw proved edge assistants can run on $10 hardware with a Go binary under 10MB of RAM.

ZeptoClaw took notes. The integrations, the security, the governance, the size discipline — without the tradeoffs each one made. One 6MB Rust binary that starts in 50ms, uses 6MB of RAM, and ships with container isolation, prompt injection detection, and a circuit breaker provider stack.

OpenClaw NemoClaw NanoClaw PicoClaw ZeptoClaw
Core shape Broad TypeScript assistant + skills ecosystem OpenClaw managed through OpenShell Small TypeScript Claude assistant Go edge assistant Single Rust binary
Footprint focus Integration breadth Docker/k3s guardrails, ~2.4GB sandbox image ~500-line core
Deploy to DigitalOcean
Deploy to Railway
Deploy to Render
Deploy to Fly.io

Any VPS

curl -fsSL https://zeptoclaw.com/setup.sh | bash

Installs the binary and prints next steps. Run zeptoclaw onboard to configure providers and channels.

Providers

ZeptoClaw supports 18 LLM providers. All OpenAI-compatible endpoints work out of the box.

Provider Config key Setup
Anthropic anthropic api_key
OpenAI openai api_key
OpenRouter openrouter api_key
Google Gemini gemini api_key
Google Vertex AI vertex ADC or access token
Groq groq api_key
DeepSeek deepseek api_key
xAI (Grok) xai api_key
NVIDIA NIM nvidia api_key
Azure OpenAI azure api_key + api_base
AWS Bedrock bedrock api_key
Kimi (Moonshot) kimi api_key
Zhipu (GLM) zhipu api_key
Qianfan (Baidu) qianfan api_key
Novita AI novita api_key
Liquid AI liquid api_key
Ollama ollama local/keyless
VLLM vllm local/keyless

Configure in ~/.zeptoclaw/config.json or via environment variables:

{
  "providers": {
    "openrouter": { "api_key": "sk-or-..." },
    "ollama": { "api_key": "ollama" }
  },
  "agents": { "defaults": { "model": "anthropic/claude-sonnet-4" } }
}
export ZEPTOCLAW_PROVIDERS_GROQ_API_KEY=gsk_...

Any provider's base URL can be overridden with api_base for proxies or self-hosted endpoints. See the provider docs for full details.

Features

Core

Feature What it does
Multi-Provider LLM 18 providers with SSE streaming, retry with backoff + budget cap, auto-failover
33 Tools + Plugins Shell, filesystem, grep, find, web, git, stripe, PDF, transcription, Android ADB, and more
Tool Composition Create new tools from natural language descriptions — composable {{param}} templates
Agent Swarms Delegate to sub-agents with parallel fan-out, aggregation, and cost-aware routing
Library Facade Embed as a crate — ZeptoAgent::builder().provider(p).tool(t).build() for Tauri/GUI apps
Batch Mode Process hundreds of prompts from text/JSONL files with template support
Agent Modes Observer, Assistant, Autonomous — category-based tool access control

Channels & Integration

Feature What it does
Multi-Channel Gateway Telegram, Slack, Discord, WhatsApp Web + Cloud API, Lark, Email, Webhook, Serial, ACP, plus plugin channels — unified message bus
Persona System Per-chat personality switching via /persona command with LTM persistence
Plugin System JSON manifest plugins auto-discovered from ~/.zeptoclaw/plugins/
Hooks before_tool, after_tool, on_error with Log, Block, and Notify actions
Cron & Heartbeat Schedule recurring tasks, proactive check-ins, background spawning
Memory & History Workspace memory, long-term key-value store, conversation history

Security & Ops

Feature What it does
6 Sandbox Runtimes Docker, Apple Container, Landlock, Firejail, Bubblewrap, or native
Gateway Startup Guard Degrade gracefully after N crashes — prevents crash loops
Channel Supervisor Auto-restart dead channels with cooldown and max-restart limits
Tool Approval Gate Policy-based gating — require confirmation for dangerous tools
SSRF Prevention DNS pinning, private IP blocking, IPv6 transition guard, scheme validation
Shell Blocklist Regex patterns blocking reverse shells, rm -rf, privilege escalation
Token Budget & Cost Per-session budget enforcement, per-model cost estimation for 8 models
Rich Health Endpoint /health with version, uptime, RSS, usage metrics, component checks
Telemetry Prometheus + JSON metrics export, structured logging, per-tenant tracing
Self-Update zeptoclaw update downloads latest release from GitHub
Loop Guard SHA256 tool-call repetition detection with circuit-breaker stop
Context Trimming Normal/emergency/critical compaction tiers (70%/90%/95%) for context window management
Session Repair Auto-fixes orphan tool results, empty/duplicate messages, and alternation issues
Config Hot-Reload Gateway polls config mtime every 30s and applies provider/channel/safety updates live
Hands-Lite HAND.toml agent profiles with bundled presets (researcher, coder, monitor) and hand CLI
Multi-Tenant Hundreds of tenants on one VPS — isolated workspaces, ~6MB RAM each

Full documentation — zeptoclaw.com/docs covers configuration, environment variables, CLI reference, deployment guides, and more.

Inspired By

ZeptoClaw is inspired by projects in the open-source AI agent ecosystem — OpenClaw, NemoClaw, NanoClaw, and PicoClaw — each taking a different approach to the same problem. NemoClaw's policy model, routed inference, credential boundary, and digest-verified blueprint flow influenced our security thinking. ZeptoClaw's contribution is Rust's memory safety, async performance, and configurable isolation for local-first, edge, and production multi-tenant deployments — all in a 6MB binary that runs where Docker containers can't.

Usage

# CLI agent (one-shot or streaming)
zeptoclaw agent -m "Summarize this repo"
zeptoclaw agent --stream -m "Explain async Rust"
zeptoclaw agent --template coder -m "Add error handling to main.rs"

# Multi-channel gateway
zeptoclaw gateway                    # Telegram, Slack, Discord, etc.
zeptoclaw gateway --containerized    # With container isolation per request

# Memory, secrets, profiles
zeptoclaw memory set project:name "ZeptoClaw" --category project
zeptoclaw secrets encrypt
zeptoclaw hand activate researcher

# Batch, diagnostics, self-update
zeptoclaw batch --input prompts.txt --output results.jsonl
zeptoclaw doctor                     # Diagnose config/provider issues
zeptoclaw update                     # Self-update to latest release

Development

# Build
cargo build

# Run all tests (~3,900 total)
cargo nextest run --lib

# Lint and format (required before every PR)
cargo clippy -- -D warnings
cargo fmt -- --check

See CLAUDE.md for full architecture reference, AGENTS.md for coding guidelines, and docs/ for benchmarks, multi-tenant deployment, and performance guides.

Zepto Stack

ZeptoClaw is part of the Zepto stack — a modular local-first system for running on-device AI agents in production.

ZeptoPM        — orchestration, supervision, retries, job lifecycle
    │
    │  create(spec) + spawn(worker, args, env)
    ▼
ZeptoCapsule   — capsule creation, process isolation, resource enforcement
    │
    │  fork/namespace/microVM + stdio transport
    ▼
ZeptoClaw      — LLM calls, tool use, artifact production
    │
    └── JSON-line IPC over stdin/stdout back to ZeptoPM
Layer Repo Role
ZeptoPM qhkm/zeptopm Process manager — config-driven daemon, HTTP API, pipelines, orchestration
ZeptoCapsule qhkm/zeptocapsule Sandbox — process/namespace/Firecracker isolation, resource limits, fallback chains
ZeptoRT qhkm/zeptort Durable runtime — journaled effects, snapshot recovery, OTP-style supervision
ZeptoClaw qhkm/zeptoclaw Personal AI assistant infrastructure — tools, memory, providers, channels, sandboxed autonomy

Contributing

We welcome contributions! Please read CONTRIBUTING.md for:

  • How to set up your fork and branch from upstream
  • Issue-first workflow (open an issue before coding)
  • Pull request process and quality gates
  • Guides for adding new tools, channels, and providers

License

Apache 2.0 — see LICENSE

Disclaimer

ZeptoClaw is a pure open-source software project. It has no token, no cryptocurrency, no blockchain component, and no financial instrument of any kind. This project is not affiliated with any token or financial product.


ZeptoClaw — Local-first personal AI assistant infrastructure in one Rust binary.

Built by Aisar Labs


For commercial licensing, enterprise support, or managed hosting inquiries: qaiyyum@aisar.ai

Frequently asked questions

Is zeptoclaw free to use?

zeptoclaw is open source under the Apache-2.0 licence. There is no licence fee and no seat count — you can self-host it or, where the project offers one, pay a vendor for a managed version instead.

What does zeptoclaw do?

Fast, small, secure, local-first personal AI assistant infrastructure: one Rust binary for tools, memory, channels, providers, and sandboxed autonomy.

What is zeptoclaw written in?

zeptoclaw is primarily written in Rust. Its source is publicly available at https://github.com/qhkm/zeptoclaw, and it has 652 GitHub stars.