Metadata-Version: 2.4
Name: safe-colab-cli
Version: 0.7.5
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
Provides-Extra: sandbox
Requires-Dist: nono-py>=0.1.0; extra == "sandbox"
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21; 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, registers it as a remote service via [Hypha](https://hypha.aicell.io), 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
- **Zero Config for Agents** — Agents call `get_skill_md` via curl to learn the API. No SDK, no token needed.

## Quick Start

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

## Documentation

See the [project page](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.
