https://github.com/capiscio/capiscio-python
The official CapiscIO CLI tool for validating A2A agents. A lightweight Python wrapper that automatically manages the capiscio-core binary.
https://github.com/capiscio/capiscio-python
a2a a2a-protocol agent-to-agent automation capiscio cli devops python security validation wrapper
Last synced: about 1 month ago
JSON representation
The official CapiscIO CLI tool for validating A2A agents. A lightweight Python wrapper that automatically manages the capiscio-core binary.
- Host: GitHub
- URL: https://github.com/capiscio/capiscio-python
- Owner: capiscio
- License: apache-2.0
- Created: 2025-11-21T03:38:21.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-01-14T21:16:21.000Z (3 months ago)
- Last Synced: 2026-01-16T20:42:26.670Z (3 months ago)
- Topics: a2a, a2a-protocol, agent-to-agent, automation, capiscio, cli, devops, python, security, validation, wrapper
- Language: Python
- Homepage: https://capisc.io
- Size: 113 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# 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
# 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