Skip to main content

Airut

Sandboxed Claude Code over email and Slack. Named "Airut" (Finnish: herald/messenger).

Send a message — email or Slack — with instructions, and get results back in the same thread. Starting a new task is as simple as starting a new conversation. Airut handles everything behind the scenes: workspace creation, container isolation, network sandboxing, session persistence, and cleanup.

Self-hosted: your code and conversations never leave your infrastructure.

You → Email/Slack → Airut → Claude Code (container) → PR → Reply → You

Key Features

  • Zero-friction tasking — send a message to start a task. No workspace setup, no session management, no cleanup.
  • Defense-in-depth sandboxing — container isolation, network allowlist via proxy, and credential masking limit blast radius when agents run with full autonomy.
  • Conversation persistence — reply to continue where you left off. Claude Code session context is maintained across messages.
  • Task-to-PR foundation — combined with proper repo configuration (CLAUDE.md, CI tooling, branch protection), enables end-to-end autonomous workflows where agents push PRs for human review.
  • Email and Slack channels — authenticate via DMARC and DKIM (email) or workspace membership (Slack), with sender authorization per repo.
  • Web dashboard — monitor running tasks, view network activity logs, and configure the server.

Quick Start

Prerequisites

  • Linux (dedicated VM recommended, Debian 13 tested)
  • uv, Git, and Podman (rootless)
  • At least one channel per repository:
    • Email: Dedicated email account with IMAP/SMTP access
    • Slack: Slack workspace with app installation permissions

Install

# Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install Airut from PyPI
uv tool install airut

Or install the latest development version from main:

uv tool install airut --from git+https://github.com/airutorg/airut.git

Deploy

# Validate system dependencies
airut check

# Install and start the systemd service
airut install-service

Configure

Open http://localhost:5200 in your browser. Click Configure to open the config editor. Add repositories, set up channels, configure credentials, and adjust resource limits.

You can also edit ~/.config/airut/airut.yaml directly. See the documented example for the full schema.

Update

airut update

How It Works

Each conversation runs in an isolated container with its own git workspace, Claude Code session, and sandboxed network. The recommended workflow has agents push PRs for your review — you review, leave comments, and reply to iterate.

You: "Add user authentication"
    ↓
Agent: works → pushes PR → replies with PR link
    ↓
You: review PR, leave comments
    ↓
You: reply "Address the review comments"
    ↓
Agent: reads comments → fixes → updates PR → replies
    ↓
You: approve and merge

Sandbox Library

The airut.sandbox module is a standalone library for safe containerized execution of headless Claude Code. It can be used independently of the gateway to run Claude Code in isolated containers from any Python application — CI pipelines, automation scripts, custom integrations, or your own agent orchestrator.

Core capabilities:

  • Container lifecycle — two-layer image build, execution, and cleanup via Podman or Docker
  • Network isolation — transparent DNS-spoofing proxy enforcing a domain allowlist, with no HTTP_PROXY env vars or iptables rules needed
  • Secret masking — surrogate credential injection so real secrets never reach the container, with proxy-side replacement on egress
  • Event streaming — append-only log of Claude's streaming JSON output, safe for concurrent reads during execution
  • Outcome classification — typed Outcome enum (success, timeout, prompt-too-long, session-corrupted, container-failed) so callers match on outcomes instead of parsing strings

Quick example:

from airut.sandbox import (
    ContainerEnv,
    ImageBuildSpec,
    Mount,
    Outcome,
    Sandbox,
    SandboxConfig,
)

sandbox = Sandbox(SandboxConfig())
sandbox.startup()

image = sandbox.ensure_image(
    ImageBuildSpec(kind="repo", dockerfile=dockerfile, context_files=files)
)
task = sandbox.create_task(
    execution_context_id="my-run-1",
    execution_context_dir=run_dir,
    image_tag=image,
    mounts=[Mount(host_path=repo, container_path="/workspace")],
    env=ContainerEnv(variables={"ANTHROPIC_API_KEY": key}),
    timeout_seconds=600,
)
result = task.execute("Fix the failing tests")

if result.outcome == Outcome.SUCCESS:
    print(result.response_text)

sandbox.shutdown()

See the sandbox spec for full architecture details and API reference.

Documentation

Full documentation is available on GitHub:

License

MIT License. See LICENSE for details.

Metadata

Release files for airut 0.28.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for airut 0.28.0
File Size Uploaded Provenance Actions
airut-0.28.0.tar.gz 1.9 MB With provenance Details for airut-0.28.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for airut 0.28.0
File Interpreter ABI Platform Actions
airut-0.28.0-py3-none-any.whl Python 3 none any Details for airut-0.28.0-py3-none-any.whl

Total release size: 2.5 MB

Release files / airut-0.28.0.tar.gz

Download URL airut-0.28.0.tar.gz
Size 1.9 MB
Tags Source
SHA-256 checksum
How to use checksums
4c171ef2e01be527b7cfa41dd9dd69b6413bfc116e572f3997625ab9f71008b2
BLAKE2b-256 checksum
How to use checksums
68aa5555a2b89acf100ef8e9545a578667f52e86b1bbf1cf2017ce4102261a1f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

Release files / airut-0.28.0-py3-none-any.whl

Download URL airut-0.28.0-py3-none-any.whl
Size 614.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
488359a4dae62a8898f98c44da01ced7856a52d98a9ed9814d2737557558e743
BLAKE2b-256 checksum
How to use checksums
b177bc06703492387f6e7c77cbb998982f519c5b698ed238978808db814e844c
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

Security for airut 0.28.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for airut-0.28.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 12, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.28.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page