This release is a pre-release and may not be stable for production use.
bella-baxter
Python SDK for the Bella Baxter secrets management platform. Includes built-in end-to-end encryption and webhook signature verification.
When to use bella-baxter directly
Most applications should use a framework integration instead:
| Framework | Package |
|---|---|
| Django | bella-baxter-django |
| FastAPI | bella-baxter-fastapi |
| Flask | bella-baxter-flask |
| Scripts, tools, custom integrations | bella-baxter (this package) |
Installation
pip install bella-baxter
Quickstart
from bella_baxter import BaxterClient, BaxterClientOptions
client = BaxterClient(BaxterClientOptions(
baxter_url="https://api.bella-baxter.io",
api_key="bax-...",
))
# Fetch all secrets (sync — works in Django, Flask, scripts)
secrets = client.get_all_secrets()
db_url = secrets.secrets["DATABASE_URL"]
# Async (FastAPI, asyncio)
secrets = await client.get_all_secrets_async()
Authentication
API key (recommended for apps and CI/CD)
# Generate a key via the CLI
bella api-keys create --env production --name "MyApp Production"
# Returns: bax-<keyId>-<secret>
import os
from bella_baxter import BaxterClient, BaxterClientOptions
client = BaxterClient(BaxterClientOptions(
baxter_url=os.environ["BELLA_BAXTER_URL"],
api_key=os.environ["BELLA_BAXTER_API_KEY"],
))
API keys encode the project and environment slug — no config file needed.
Generate via bella api-keys create or the Bella WebApp.
OAuth (local dev)
bella login # opens browser, stores token in .bella file
bella exec -- python app.py # injects BELLA_BAXTER_API_KEY + BELLA_BAXTER_URL automatically
End-to-end encryption
Secret values are encrypted client-side using ECIES (Elliptic Curve Integrated Encryption Scheme) before being sent to the Baxter API. Decryption happens transparently in the SDK.
E2EE is included — no extra install needed (cryptography>=41 is a core dependency).
Lightweight version polling
For long-running processes that need to detect secret rotations:
# Check if secrets have changed without fetching values
version = client.get_secrets_version()
if version.version != last_known_version:
secrets = client.get_all_secrets()
last_known_version = version.version
Webhook signature verification
from bella_baxter import verify_webhook_signature
is_valid = verify_webhook_signature(
payload=request.body,
signature_header=request.headers["X-Bella-Signature"],
secret="whsec-...",
)
Full API access (Kiota client)
# Access the underlying Kiota client for full API coverage
kiota = client.client
# List projects
projects = await kiota.api.v1.projects.get()
# Manage environments, providers, users, API keys, etc.
Regenerating the generated client
bella-baxter embeds a Kiota-generated HTTP client. To regenerate after an API change:
cd apps/sdk
./generate.sh
1 maintainer
Release files for bella-baxter 0.1.1rc106
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| bella_baxter-0.1.1rc106.tar.gz | 177.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| bella_baxter-0.1.1rc106-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 977.7 kB
Release files / bella_baxter-0.1.1rc106.tar.gz
| Download URL | bella_baxter-0.1.1rc106.tar.gz |
|---|---|
| Size | 177.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9573807bf85e9ddd6798bfd0df447d04e488740f4b249216cb78c045ffadee03
|
|
BLAKE2b-256 checksum How to use checksums |
8935994c22b295684cdd39b146cff4c470fd846cf60e74e6c887210e1121a418
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency logRelease files / bella_baxter-0.1.1rc106-py3-none-any.whl
| Download URL | bella_baxter-0.1.1rc106-py3-none-any.whl |
|---|---|
| Size | 800.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8217fb560ad204d24c675a55e088e3408ddea94401f6ca5108e907efb2042051
|
|
BLAKE2b-256 checksum How to use checksums |
18a35e64a288b48267621af2154d7a75c8b104e610d885e89c2f34b4cc45667a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 15, 2026.
Transparency log
