semvec/pypi-packages huggingface dataset:
capiscio 2.4.0
The official CapiscIO CLI tool for validating A2A agents.
License: Apache-2.0
Requires Python: >=3.10
Keywords: a2a, agent, capiscio, cli, tool, validation

# CapiscIO CLI (Python)

**The official command-line interface for CapiscIO, the Agent-to-Agent (A2A) validation platform.**

[![PyPI version](https://badge.fury.io/py/capiscio.svg)](https://badge.fury.io/py/capiscio)
[![Python Versions](https://img.shields.io/pypi/pyversions/capiscio.svg)](https://pypi.org/project/capiscio/)
[![License](https://img.shields.io/github/license/capiscio/capiscio-python)](https://github.com/capiscio/capiscio-python/blob/main/LICENSE)
[![Downloads](https://pepy.tech/badge/capiscio)](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

# Validate with JSON output
capiscio validate https://my-agent.example.com --json

# 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