capiscio-python

# CapiscIO CLI (Python) **The official command-line interface for CapiscIO, the Agent-to-Agent (A2A) validation platform.** [](https://badge.fury.io/py/capiscio) [](https://pypi.org/project/capiscio/) [](https://github.com/capiscio/capiscio-python/blob/main/LICENSE) [](https://pepy.tech/project/capiscio) ## Overview This package provides a convenient Python distribution for the **CapiscIO CLI**. It acts as a smart wrapper that automatically manages the underlying `capiscio-core` binary (written in Go), ensuring you always have the correct executable for your operating system and architecture. > **Note:** This is a wrapper. The core logic resides in [capiscio-core](https://github.com/capiscio/capiscio-core). ## Installation ```bash pip install capiscio ``` ## Usage Once installed, the `capiscio` command is available in your terminal. It passes all arguments directly to the core binary. ```bash # Validate an agent capiscio validate https://my-agent.example.com # Check compliance score capiscio score https://my-agent.example.com # Check version capiscio --version ``` ### Wrapper Utilities The Python wrapper includes specific commands to manage the binary: | Command | Description | |---------|-------------| | `capiscio --wrapper-version` | Display the version of this Python wrapper package. | | `capiscio --wrapper-clean` | Remove the cached `capiscio-core` binary (forces re-download on next run). | ## How It Works 1. **Detection**: When you run `capiscio`, the script detects your OS (Linux, macOS, Windows) and Architecture (AMD64, ARM64). 2. **Provisioning**: It checks if the correct `capiscio-core` binary is present in your user cache. * *Linux*: `~/.cache/capiscio/bin` * *macOS*: `~/Library/Caches/capiscio/bin` * *Windows*: `%LOCALAPPDATA%\capiscio\bin` 3. **Download**: If missing, it securely downloads the release from GitHub. 4. **Execution**: It seamlessly replaces the Python process with the Go binary, ensuring zero overhead during execution. ## Supported Platforms - **macOS**: AMD64 (Intel), ARM64 (Apple Silicon) - **Linux**: AMD64, ARM64 - **Windows**: AMD64 ## Troubleshooting **"Permission denied" errors:** Ensure your user has write access to the cache directory. You can reset the cache by running: ```bash capiscio --wrapper-clean ``` **"Binary not found" or download errors:** If you are behind a corporate firewall, ensure you can access `github.com`. ## License Apache-2.0