Metadata-Version: 2.4
Name: safe-colab-cli
Version: 0.17.1
Summary: CLI tool for safe collaboration - sandboxed Jupyter kernel with remote Hypha service access
Author: Amun AI AB
License: All Rights Reserved
Keywords: safe-colab,sandbox,jupyter,hypha,remote-execution
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: hypha-rpc>=0.20.0
Requires-Dist: jupyter_client>=8.0
Requires-Dist: ipykernel>=6.0
Requires-Dist: click>=8.0
Requires-Dist: python-dotenv>=1.0
Requires-Dist: httpx>=0.24.0
Requires-Dist: aiohttp>=3.9
Requires-Dist: nono-py>=0.1.0; sys_platform != "win32"
Requires-Dist: pandas>=2.0
Requires-Dist: numpy>=1.24
Provides-Extra: desktop
Requires-Dist: aiohttp>=3.9; extra == "desktop"
Provides-Extra: sandbox
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
Requires-Dist: pytest-timeout>=2.0; extra == "dev"
Requires-Dist: pytest-aiohttp>=1.0; extra == "dev"
Requires-Dist: aiohttp>=3.9; extra == "dev"
Requires-Dist: pyyaml>=6.0; extra == "dev"

# Safe Colab CLI

**Enable AI agents to analyze your sensitive data remotely — without ever copying it.**

A command-line tool that launches a sandboxed Python environment on your machine (or in the cloud), registers it as a remote service via [Hypha](https://hypha.amun.ai), and lets AI agents execute code through a guardian agent that enforces your sensitivity policy.

## Key Features

- **Guardian Agent** — LLM-powered security checks validate code before execution and output before return
- **Sensitivity Contract** — Define protected columns, minimum aggregation, and allowed operations in a README.md
- **Live Dashboard** — Web dashboard with real-time activity log and operation stats
- **Protected Audit Logs** — Full audit trail in `~/.safe-colab/logs/`, protected from sandboxed code
- **Sandbox Isolation** — nono (macOS/Linux) or Docker restricts kernel filesystem access
- **Remote Hosting** — Upload dataset once, cloud pods spin up on demand (no laptop needed)
- **Zero Config for Agents** — Agents call `get_skill_md` via curl to learn the API. No SDK, no token needed.

## Quick Start

### Local Mode (data stays on your machine)

```bash
pip install safe-colab-cli
safe-colab login --server-url https://hypha.amun.ai
safe-colab start --data-dir ./my-data --guardian-url https://guard.amun.ai
```

### Remote Mode (upload once, pods on demand)

```bash
pip install safe-colab-cli
safe-colab login --server-url https://hypha.amun.ai
safe-colab deploy --data-dir ./my-data --guardian-url https://guard.amun.ai
# → Uploads dataset, registers app. Share the App ID with your AI agent.
# → Pods spin up automatically when an agent calls start().
```

### Use the Amun AI production servers

Safe Colab talks to **two** services and both must point at the Amun AI
deployment (older installs and some docs default to an `aicell.io` instance):

| Service | Amun AI URL | How to set it |
|---------|-------------|---------------|
| **Hypha** (registers your kernel; chosen at **login**) | `https://hypha.amun.ai` | `safe-colab login --server-url https://hypha.amun.ai` |
| **Guardian** (validates every code/output) | `https://guard.amun.ai` | `--guardian-url https://guard.amun.ai` on `start`/`deploy` |

The Hypha server is fixed **at login time** — if you logged in against a
different server, re-run `safe-colab login --server-url https://hypha.amun.ai`
to overwrite the saved credentials in `~/.safe-colab/.env`. You can also set
both via environment (persist them in your shell profile):

```bash
export HYPHA_SERVER_URL=https://hypha.amun.ai
export SAFE_COLAB_GUARDIAN_URL=https://guard.amun.ai
```

Verify the guardian before a session or demo (accepts the Terms of Use, then
runs a built-in safe/blocked suite):

```bash
safe-colab test-guardian --url https://guard.amun.ai --accept-terms
# → Health: OK … 4/4 tests passed
```

## Documentation

See the [docs site](https://aicell-lab.github.io/safe-colab-cli/) or the [GitHub project](https://github.com/aicell-lab/safe-colab-cli) for full documentation.

## License

Copyright 2024-2026 Amun AI AB. All rights reserved.

This software is proprietary and confidential. No part of this software may be reproduced, distributed, or transmitted in any form or by any means without the prior written permission of Amun AI AB. Unauthorized copying, modification, distribution, or use of this software is strictly prohibited.
