Python SDK

The official Python client for FyVault. Supports secrets, environments, agent credentials, providers, compliance, and break-glass access.

Installation

pip install fyvault

Quick start

from fyvault import FyVault

# Zero-config — auto-detects credentials
fv = FyVault.auto()

# Or explicit
fv = FyVault(access_token="fv_live_...", org_id="org_acme")

Resources

Secrets

# Get a secret value
value = fv.secrets.get_value_by_name("DATABASE_URL", environment="production")

# List secrets
secrets = fv.secrets.list(environment="production")

# Create a secret
fv.secrets.create(name="API_KEY", value="sk-...", environment="staging")

Environments

envs = fv.environments.list()
fv.environments.create(name="preview", description="PR previews")

Agent credentials

cred = fv.agent_credentials.create(
    name="ci-bot",
    scopes=["secrets:read"],
    rate_limit=60,
)
fv.agent_credentials.revoke(cred.id)

Providers

fv.providers.issue(
    secret_name="DB_PASSWORD",
    environment="production",
    value="new_pass_123",
)
fv.providers.rotate(secret_name="DB_PASSWORD", environment="production", new_value="rotated_456")

Compliance

report = fv.compliance.generate(framework="soc2")
print(report.summary)

Break-glass

session = fv.break_glass.create(reason="Production DB outage", ttl_seconds=3600)
secret = fv.break_glass.get_secret(session.id, "DATABASE_URL")

Async support

from fyvault import AsyncFyVault

fv = AsyncFyVault.auto()
value = await fv.secrets.get_value_by_name("DATABASE_URL")