Getting Started¶

Get up and running with CapiscIO in minutes. One command gives your AI agent a cryptographic identity, just like Let's Encrypt did for HTTPS.

Quick Install¶

npm install -g capiscio       # or: pip install capiscio

The Fastest Path: One Command Setup¶

Get a complete agent identity in under 60 seconds:

# Set your API key (get one free at app.capisc.io)
export CAPISCIO_API_KEY=sk_live_...

# That's it! One command does everything:
capiscio init

from capiscio_sdk import CapiscIO

# One line - handles everything automatically
agent = CapiscIO.connect(api_key="sk_live_...")

print(agent.did)    # did:key:z6Mk...
print(agent.badge)  # Your trust badge

# Set CAPISCIO_API_KEY in your environment
agent = CapiscIO.from_env()

What happens automatically:

1. ✅ Ed25519 key pair generated
2. ✅ did:key identity derived (RFC-002 compliant)
3. ✅ DID registered with CapiscIO registry
4. ✅ Agent card created with x-capiscio extension
5. ✅ Trust badge requested and stored

Choose Your Setup Path¶

What You Get¶

After running capiscio init, your .capiscio/ directory contains:

.capiscio/
├── private.jwk      # Ed25519 private key (keep secret!)
├── public.jwk       # Public key
├── did.txt          # Your agent's did:key identifier
└── agent-card.json  # A2A-compliant agent card

Your agent now has:

• Cryptographic identity - A globally unique did:key that proves who you are
• Verifiable credentials - Sign messages and prove authenticity
• Trust badge - Registered with CapiscIO for discovery and verification
• A2A compliance - Ready to interact with other A2A agents

Choose Your Next Step¶

Manual Setup (Advanced)¶

If you need more control, you can still do things step-by-step:

# Generate keys only (no server registration)
capiscio key gen --out-priv private.jwk --out-pub public.jwk

# Derive DID from existing key
capiscio key did --in public.jwk

See the CLI Reference for all options.

Prerequisites¶

SDK Quick Reference¶

from capiscio_sdk import CapiscIO

# Connect and get full identity
agent = CapiscIO.connect(api_key="sk_live_...")

# Or from environment
agent = CapiscIO.from_env()  # Uses CAPISCIO_API_KEY

# Use the agent
print(agent.did)           # did:key:z6Mk...
print(agent.badge)         # Current trust badge
print(agent.status())      # Full status dict

# Emit events for observability
agent.emit("task_started", {"task_id": "123"})

import { CapiscIO } from 'capiscio';

// Connect and get full identity
const agent = await CapiscIO.connect({ apiKey: 'sk_live_...' });

console.log(agent.did);    // did:key:z6Mk...
console.log(agent.badge);  // Current trust badge

# Initialize agent identity
capiscio init --api-key $CAPISCIO_API_KEY

# Or with explicit agent ID
capiscio init --agent-id agt_abc123

# View your identity
cat .capiscio/did.txt

What's Next?¶

After getting started, explore: