Getting Started¶

Get up and running with CapiscIO in minutes. Choose your path based on what you want to accomplish.

Quick Install¶

npm install -g capiscio       # or: pip install capiscio

Choose Your Path¶

Get Agent Identity

Generate a DID for your agent in 60 seconds.
```
capiscio key gen
```
Identity Guide
Validate Your Agent

Ensure your agent card is A2A-compliant.

5 minutes · Beginner

Start Validating
Secure Your Agent

Add cryptographic identity and request verification.

15 minutes · Intermediate

Add Security
CI/CD Integration

Automate validation in GitHub Actions.

10 minutes · Intermediate

Setup CI/CD
Complete Workflow

End-to-end guide: identity → badge → validation → deployment.

30 minutes · Comprehensive

Full Walkthrough

The Fast Path¶

If you just want to try CapiscIO quickly:

# 1. Install
npm install -g capiscio

# 2. Create a sample agent card
cat > agent-card.json << 'EOF'
{
  "name": "My Test Agent",
  "description": "Testing CapiscIO validation",
  "url": "https://example.com/agent",
  "version": "1.0.0",
  "protocolVersion": "0.2.0",
  "skills": [{ "id": "test", "name": "Test Skill", "description": "A test skill" }]
}
EOF

# 3. Validate
capiscio validate agent-card.json

# 4. Generate identity
mkdir -p capiscio_keys && cd capiscio_keys && capiscio key gen && cd ..

Done! You have a validated agent card and a cryptographic identity.

Prerequisites¶

Path	Requirements
CLI (validate, key gen)	Node.js 18+ or Python 3.10+
Python SDK (SimpleGuard)	Python 3.10+, FastAPI or similar
CI/CD	GitHub repository

What's Next?¶

After getting started, explore:

Get a Trust Badge

Upgrade from self-signed to verified trust.

Trust Badges
Understand the Concepts

Learn how validation, scoring, and trust work.

Concepts
How-To Guides

Solve specific problems with copy-paste recipes.

How-To Guides