Metadata-Version: 2.3
Name: slopbox-env
Version: 0.2.2
Summary: A secure-ish environment for running AI agents.
Requires-Dist: click>=8.4.2
Requires-Dist: pydantic>=2.13.4
Requires-Python: >=3.14
Description-Content-Type: text/markdown

# slopbox
**A secure-ish environment for running AI agents.**

The goal of this project is to make it very easy to set up
an _isolated runtime_ (container or virtual machine) for an AI agent.

What you can expect:
* intuitive configuration with sane defaults
* principle of least privilege
   * include only the packages that are neccessary for the agent to operate
   * restrict agent's network access through a customizable proxy
   * grant access only to a subset of directories
* just works™

**DISCLAIMER**: this project is on a very early stage of development -- things will break, things will change.

## Requirements
- Nix
- Podman or Docker
   - rootless mode required
   - guide for docker on NixOS: https://wiki.nixos.org/wiki/Docker#Rootless_Docker

## Install

### PyPI
slopbox is available in [pypi](https://pypi.org/project/slopbox-env/) as `slopbox-env` package.

Example install with [`uv`](https://docs.astral.sh/uv/):
```
$ uv tool install slopbox-env
$ slopbox --version
```

### Nix
Repository flake exposes slopbox as a package.

#### Try out slopbox
Temporarily add slopbox to your shell:
```
$ nix shell github:jkbSeven/slopbox
$ slopbox --version
```

#### Use slopbox in your flake
Add slopbox flake to your flake inputs:
```nix
inputs = {
  nixpkgs.url = "github:nixos/nixpkgs";

  slopbox = {
    url = "github:jkbSeven/slopbox";
    inputs.nixpkgs.follows = "nixpkgs";
  };
};
```

Reference the package in your flake as `slopbox.packages.${system}.default`

## Docs
No documentation is available at this point.

## What's next
See the list of [planned features](https://github.com/jkbSeven/slopbox/issues?q=is%3Aissue+state%3Aopen+author%3AjkbSeven+label%3Aenhancement)
