Skip to content

Step 2: Installation

The CapiscIO CLI is available for Node.js and Python. Choose your preferred platform.

Install the CLI

npm install -g capiscio

Verify the installation:

capiscio --version

Expected output: 

capiscio/2.1.x (darwin-arm64)


pip install capiscio

Verify the installation:

capiscio --version

Expected output: 

capiscio/2.1.x (darwin-arm64)

If you have Go installed, you can install the core binary directly:

go install github.com/capiscio/capiscio-core/cmd/capiscio@latest

Verify the installation:

capiscio --version

How It Works

The npm and pip packages are thin wrappers around the capiscio-core Go binary. On first run, they automatically download the correct binary for your platform. This ensures consistent behavior across all languages.

First Run

The first time you run capiscio, it will download the core binary:

capiscio --help

You should see:

The core engine for the CapiscIO ecosystem.
Validates Agent Cards, verifies signatures, and scores agent trust and availability.

Usage:
  capiscio [command]

Available Commands:
  badge       Manage Trust Badges
  gateway     Start the CapiscIO Gateway
  help        Help about any command
  key         Manage Cryptographic Keys
  validate    Validate an Agent Card

Flags:
  -h, --help      help for capiscio
  -v, --version   version for capiscio

Use "capiscio [command] --help" for more information about a command.

Troubleshooting

Permission denied on npm install

If you get a permission error, try:

npm install -g capiscio --unsafe-perm

Or use a Node version manager like nvm to avoid permission issues.

Binary download fails

The CLI downloads the binary from GitHub releases. If you're behind a corporate firewall:

  1. Download the binary manually from GitHub Releases
  2. Place it in ~/.capiscio/bin/
  3. Make it executable: chmod +x ~/.capiscio/bin/capiscio
Command not found after install

Ensure your PATH includes the npm/pip global bin directory:

# For npm
export PATH="$PATH:$(npm config get prefix)/bin"

# For pip
export PATH="$PATH:$(python -m site --user-base)/bin"

Create a Sample Agent Card

Before we validate, let's create a sample agent card to work with:

cat > agent-card.json << 'EOF'
{
  "name": "My First Agent",
  "description": "A sample A2A agent for learning CapiscIO",
  "url": "https://example.com/agent",
  "version": "1.0.0",
  "protocolVersion": "0.2.0",
  "provider": {
    "organization": "My Company"
  },
  "capabilities": {
    "streaming": false,
    "pushNotifications": false
  },
  "skills": [
    {
      "id": "greeting",
      "name": "Greeting", 
      "description": "Returns a friendly greeting"
    }
  ]
}
EOF

Verify the file was created:

cat agent-card.json

What's Next?

You now have:

  • CapiscIO CLI installed
  • A sample agent-card.json file

Let's run your first validation!

Back Continue