Skip to main content

Prerequisites

Steps

1

Install the SDK

pip install anima-labs
2

Create an agent and provision a vault

Each vault is scoped to a single agent. Call provision once before storing any credentials.
from anima import Anima

anima = Anima(api_key="ak_...")

agent = anima.agents.create(name="Web Agent")
anima.vault.provision(agent_id=agent.id)
3

Store a credential

credential = anima.vault.create_credential(
    agent_id=agent.id,
    name="CRM Login",
    type="login",
    username="bot@company.com",
    password="s3cur3-p4ssw0rd",
    uris=["https://crm.company.com"],
)

print(f"Stored: {credential.name}")
4

Retrieve the credential

creds = anima.vault.get_credential(
    agent_id=agent.id,
    credential_id=credential.id,
)

print(f"Username: {creds.username}")

Credential types

TypeUse case
loginWebsite logins (username + password + URIs)
secure_noteFree-form encrypted text (API keys, tokens)
cardPayment card details
identityPersonal or business identity information

Next steps

Email quickstart

Send emails from your agent’s inbox.

Cards quickstart

Issue virtual cards for agent payments.

Security

Understand how Anima protects your data.

Encryption

Learn how vault credentials are encrypted at rest.