The official command-line interface for CapiscIO, the Agent-to-Agent (A2A) validation platform.
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.
pip install capiscioOnce 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 (includes scores)
capiscio validate https://my-agent.example.com --json
# Check version
capiscio versionThe 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). |
- Detection: When you run
capiscio, the script detects your OS (Linux, macOS, Windows) and Architecture (AMD64, ARM64). - Provisioning: It checks if the correct
capiscio-corebinary is present in your user cache.- Linux:
~/.cache/capiscio/bin - macOS:
~/Library/Caches/capiscio/bin - Windows:
%LOCALAPPDATA%\capiscio\bin
- Linux:
- Download: If missing, it securely downloads the release from GitHub.
- Execution: It seamlessly replaces the Python process with the Go binary, ensuring zero overhead during execution.
- macOS: AMD64 (Intel), ARM64 (Apple Silicon)
- Linux: AMD64, ARM64
- Windows: AMD64
"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.
Apache-2.0