CapiscIO CLI (Python)

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

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.

Installation

pip install capiscio

Usage

Once installed, the capiscio command is available in your terminal. It passes all arguments directly to the core binary.

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

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:

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