secretcarousel 1.0.0

Python SDK for SecretCarousel — the agent-native secret vault

secretcarousel

Python SDK for SecretCarousel — the agent-native secret vault.

Install

pip install secretcarousel

Quick Start

from secretcarousel import SecretCarouselClient

sc = SecretCarouselClient(
    api_key="sc_free_...",
    base_url="https://secretcarousel.com"
)

# Store a secret (AES-256-GCM encrypted at rest)
secret = sc.create_secret(
    name="DATABASE_URL",
    value="postgres://user:pass@host/db",
    secret_type="database-credentials"
)

# Retrieve (decrypted on demand)
result = sc.get_secret(secret["secretId"])
print(result["value"])

# List all
secrets = sc.list_secrets()

Features

• Zero dependencies (stdlib urllib only)
• Full type hints (mypy compatible)
• AES-256-GCM encrypted storage
• Secret versioning and rotation
• Time-limited share links
• Complete audit trail

API

Method	Description
list_secrets(query?)	List secrets (metadata only)
get_secret(id)	Get secret with decrypted value
create_secret(**data)	Create new secret
update_secret(id, **data)	Update (creates new version)
delete_secret(id)	Delete secret
rotate_secret(id)	Rotate secret
export_env(query)	Export as .env format
get_audit_logs(query)	Query audit trail
create_backup(**data)	Create encrypted backup

Links

• Quick Start: https://secretcarousel.com/docs/quickstart.html
• API Reference: https://secretcarousel.com/api
• CLI: https://www.npmjs.com/package/secretcarousel

License

Proprietary — Tyga.Cloud Ltd. See LICENSE file.