Quick Start

1. 1. Deploy AIM and login to your dashboard at http://localhost:3000
2. 2. Navigate to Settings → SDK Download
3. 3. Click "Download Python SDK"
4. 4. Extract the downloaded SDK package
5. 5. Start using immediately - no configuration needed!

# Navigate to your extracted SDK folder
# No installation needed - just import and use!

from aim_sdk import secure

# One line - your agent is registered AND verified!
agent = secure("my-agent")

# That's it! No API keys, no URLs, no configuration!
# The SDK already knows your credentials
# Agent is verified and ready to work immediately!

import requests

# Only needed if you're NOT using the SDK
headers = {
    "Authorization": f"Bearer {api_key}",
    "X-Organization-ID": organization_id
}

# Agent types: claude, gpt, gemini, langchain, crewai, autogen, etc.
response = requests.post(
    "http://localhost:8080/v1/agents/register",
    headers=headers,
    json={"name": "my-agent", "agentType": "langchain"}
)

# Your agent was already registered in Step 3!
# Now just use decorators for automatic verification

@agent.perform_action("db:read", resource="users_table")  # namespace:action format
def get_user_data(user_id):
    """This action is automatically verified by AIM"""
    return database.query(f"SELECT * FROM users WHERE id = {user_id}")

@agent.perform_action("notification:send", resource="admin@example.com")  # namespace:action format
def send_notification(message):
    """High-risk actions require higher trust scores"""
    send_email("admin@example.com", message)

# Call your functions normally - AIM handles verification
data = get_user_data(12345)
send_notification("System update complete")

// Create a signature
import { signPayload } from '@opena2a/aim-sdk';

const payload = {
  action: 'generate_text',
  timestamp: Date.now(),
  nonce: crypto.randomBytes(16).toString('hex')
};

const signature = await signPayload(payload, privateKey);

// Verify the agent
const verification = await client.agents.verify(
  agent.id,
  signature,
  payload
);

if (verification.valid) {
  console.log('✅ Agent identity verified');
  console.log('Trust score:', verification.trustScore);
} else {
  console.log('❌ Verification failed');
}

# Your agent needs database write access for a new feature
agent.request_capability(
    capability_type="db:write",
    reason="Need database write access for the new reporting feature"
)
# → Creates pending request for admin approval

# Admin reviews in Dashboard → Admin → Capability Requests
# Admin clicks Approve or Reject
# If approved, capability is immediately granted!