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, 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)

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)

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):

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):

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

Documentation

See the docs site or the GitHub project 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.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.18.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for oeway from gravatar.com oeway

Credits

Author: Amun AI AB

License

All Rights Reserved

Requires

Python >=3.9

Provides Extra

desktop sandbox dev

Tags

safe-colab sandbox jupyter hypha remote-execution

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

safe_colab_cli-0.17.1.tar.gz (149.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

safe_colab_cli-0.17.1-py3-none-any.whl (99.8 kB view details)

Uploaded Python 3

File details

Details for the file safe_colab_cli-0.17.1.tar.gz.

File metadata

  • Download URL: safe_colab_cli-0.17.1.tar.gz
  • Upload date:
  • Size: 149.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for safe_colab_cli-0.17.1.tar.gz
Algorithm Hash digest
SHA256 2c11790adfe2ca83a558feb24c0dcd48994a9dd132084a3d0071ef82f3dfc937
MD5 5641df7b283958c7b1c7380febda5353
BLAKE2b-256 3b6611c70fb6a60119bb041dffd81fa2338d7ce760ca3f73bc1d0535bc2513d4

See more details on using hashes here.

File details

Details for the file safe_colab_cli-0.17.1-py3-none-any.whl.

File metadata

File hashes

Hashes for safe_colab_cli-0.17.1-py3-none-any.whl
Algorithm Hash digest
SHA256 77d27499ccd9950e6a5192f89873aad3a5bf7271cadfe86f3661b952fbe14b9d
MD5 688c244a831b103b27144f0a0b1a2078
BLAKE2b-256 1f7a081325b716f053f8d064c7237c4b7d6a69431213c3311bdd329b72663895

See more details on using hashes here.

Release history Release notifications | RSS feed

0.18.0

2 files

This release

0.17.1 This release

2 files

0.17.0

2 files

0.16.0

2 files

0.15.5

2 files

0.15.4

2 files

0.15.3

2 files

0.15.2

2 files

0.15.1

2 files

0.15.0

2 files

0.13.5

2 files

0.13.4

2 files

0.13.3

2 files

0.13.2

2 files

0.13.1

2 files

0.13.0

2 files

0.12.8

2 files

0.12.7

2 files

0.12.6

2 files

0.12.5

2 files

0.12.4

2 files

0.12.3

2 files

0.12.2

2 files

0.12.1

2 files

0.12.0

2 files

0.11.9

2 files

0.11.8

2 files

0.11.7

2 files

0.11.6

2 files

0.11.5

2 files

0.11.4

2 files

0.11.3

2 files

0.11.2

2 files

0.11.1

2 files

0.11.0

2 files

0.10.9

2 files

0.10.8

2 files

0.10.7

2 files

0.10.6

2 files

0.10.5

2 files

0.10.4

2 files

0.10.3

2 files

0.10.2

2 files

0.10.1

2 files

0.10.0

2 files

0.9.2

2 files

0.9.1

2 files

0.9.0

2 files

0.8.0

2 files

0.7.6

2 files

0.7.5

2 files

0.7.4

2 files

0.7.3

2 files

0.7.2

2 files

0.7.1

2 files

0.7.0

2 files

0.6.3

2 files

0.6.2

2 files

0.6.1

2 files

0.6.0

2 files

0.5.2

2 files

0.5.1

2 files

0.5.0

2 files

0.4.2

2 files

0.4.1

2 files

0.4.0

2 files

0.3.1

2 files

0.3.0

2 files

0.2.1

2 files

0.2.0

2 files

0.1.0

2 files

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