vitibase

Python client for Vitibase — Postgres hosted in India, with an instant REST API, authentication, file storage and realtime.

pip install vitibase

import os
from vitibase import create_client, Client

vitibase: Client = create_client(
    os.environ.get("VITIBASE_PROJECT_REF"),
    os.environ.get("VITIBASE_KEY"),
)

response = vitibase.table("orders").select("id, total").eq("status", "paid").execute()

A project ref, or a URL

create_client takes either. A ref is the twenty-letter identifier on your project's Connect panel, and the URL is built for you:

create_client("abcdefghijklmnopqrst", key)   # https://abcdefghijklmnopqrst.vitibase.in
create_client("https://db.example.com", key) # used exactly as given

project_url(ref) is exported separately, for the places that need the address rather than a client.

Async

from vitibase import acreate_client

client = await acreate_client(project_ref, key)

What this package is

A thin layer over supabase, which it re-exports in full. Vitibase serves the same data-plane API, so a second client would mean maintaining a worse one and owning every bug in it.

Migrating an existing application is one import line:

-from supabase import create_client, Client
-client = create_client(SUPABASE_URL, SUPABASE_KEY)
+from vitibase import create_client, Client
+client = create_client(VITIBASE_PROJECT_REF, VITIBASE_KEY)

Every exception and helper type is the upstream object, so except PostgrestAPIError keeps working. VitibaseException and SupabaseException are the same class under two names.

Licence and attribution

Apache-2.0. Depends on supabase, which is MIT licensed and copyright Supabase, Inc. Postgres is a registered trademark of the PostgreSQL Community Association of Canada. Supabase is a trademark of Supabase, Inc., which does not endorse Vitibase.