pyronites 0.1.0

Official Python client for the Pyronites (PyroCore) backend

pyronites

Official Python client for the Pyronites backend.

Supabase-style API, zero mandatory paid services — point it at your own backend URL + API key.

Install

# Development (from this repo)
pip install -e ./pyronites

# From PyPI (after publish)
pip install pyronites

Requires Python 3.10+.

5-minute setup

export PYRONITES_URL="https://your-backend.example.com"
export PYRONITES_KEY="pyro_live_..."

from pyronites import create_client

client = create_client()

# Auth (optional)
client.auth.sign_in("[e-mail]", "password")
print(client.auth.user())

# Tables
note = client.table("notes").insert({"title": "Hello", "body": "World"})
for row in client.table("notes").select().limit(10):
    print(row)
client.table("notes").update({"title": "Updated"}).eq("id", note["id"])
client.table("notes").delete().eq("id", note["id"])

# Storage
meta = client.storage.upload("photo.jpg")
data = client.storage.download(meta["id"])
client.storage.remove(meta["id"])

# Local-only / cache tables (optional)
client = create_client(
    local_tables=["settings"],
    cache_tables=["catalog"],
    local_db_path="./.pyronites_local.db",
)
client.table("settings").insert({"theme": "dark"})
client.pull("catalog")

Config

Source	Variables / args
Env	PYRONITES_URL, PYRONITES_KEY, optional PYRONITES_LOCAL_DB
Constructor	create_client(url=..., key=..., timeout=30, local_tables=..., cache_tables=..., remote_tables=..., local_db_path=...)

Args override env. Missing URL raises a clear error at create time.

Security: never put a powerful service key in a public frontend.

Public API

See docs/syntax.md.

Development

cd pyronites
pip install -e ".[dev]"
pytest

License

MIT