Metadata-Version: 2.4
Name: capiscio
Version: 2.1.3
Summary: The official CapiscIO CLI tool for validating A2A agents.
Project-URL: Homepage, https://capisc.io
Project-URL: Documentation, https://docs.capisc.io/cli
Project-URL: Repository, https://github.com/capiscio/capiscio-python
Project-URL: Issues, https://github.com/capiscio/capiscio-python/issues
Author-email: Capiscio Team <team@capisc.io>
License: Apache-2.0
License-File: LICENSE
Keywords: a2a,agent,capiscio,cli,tool,validation
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Quality Assurance
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Requires-Dist: platformdirs>=4.0.0
Requires-Dist: requests>=2.31.0
Requires-Dist: rich>=13.0.0
Provides-Extra: dev
Requires-Dist: build; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: twine; extra == 'dev'
Description-Content-Type: text/markdown

# 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

# 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
