Skip to main content

Core Concepts

Taruvi Cloud is organized into three levels: Organizations, Sites, and Apps. Understanding this hierarchy is essential to working with the platform.

An Organization is your company or team. It owns one or more Sites, and each site is an isolated environment containing one or more Apps. Apps are where your backend resources live — datatables, functions, storage, roles, secrets, events, and analytics.

For a detailed breakdown of what sites and apps contain, the properties of each, and when to use one over the other, see Sites & Apps.

Organizations​

An Organization is the top-level entity in Taruvi — it represents your company or team.

An organization owns:

  • Members with roles (owner, admin, member)
  • Sites that contain your apps and data
  • Billing and subscription management

Every Taruvi account belongs to at least one organization. You can create multiple organizations to separate unrelated projects or clients.

See Cloud Console: Organizations for managing organizations through the web UI.

Authentication​

Taruvi uses JWT tokens scoped to a site. When a user authenticates, they receive access and refresh tokens that grant access to the apps within that site.

The SDKs handle authentication automatically — you sign in once and all subsequent requests include the token.

For details, see SDK Authentication and User Management.

Accessing Your Backend​

There are four ways to interact with Taruvi:

MethodDescriptionReference
Taruvi ConsoleWeb UI for managing organizations, sites, apps, and dataCloud Console
REST APIHTTP endpoints for all platform operationsAPI Reference
SDKsPython and JavaScript clients with type-safe interfacesSDK Overview
MCPConnect AI tools directly to your Taruvi backendMCP Integration
from taruvi import Client

# Create and authenticate
client = Client(api_url="https://api.taruvi.cloud", app_slug="my-app")
auth_client = client.auth.signInWithPassword(
    username="admin@example.com",
    password="admin"
)

# Query database
users = auth_client.database.from_("users").page_size(10).execute()
print(f"Found {len(users)} users")

# Execute function
result = auth_client.functions.execute("my-function", params={"test": True})
print(result['data'])

Installation:

pip install taruvi

SDK Features:

  • Type-safe API with full IDE autocomplete
  • Async and sync support
  • Query builder for complex queries
  • Automatic retry and error handling
  • Connection pooling for better performance

See the complete Python SDK Documentation for detailed guides and examples.

Next Steps​