freelybase 1.0.0

FreelyBase Python SDK

FreelyBase Python SDK

Python SDK for FreelyBase, aligned with the Kotlin SDK.

Installation

pip install freelybase
# with optional extras
pip install "freelybase[realtime]"   # FBLiveQuery (WebSocket)
pip install "freelybase[async]"      # AsyncFreelyBase (httpx)
pip install "freelybase[crypto]"     # EncryptedFreelyBase
pip install "freelybase[all]"        # everything

Quick Start

from freelybase import FreelyBase, FBObject, FBQuery, FBUser, FBFile, FBGeoPoint, FBAI

# Initialize
FreelyBase.initialize(app_key="your_app_id", base_url="https://your-domain.com")

# Define a model
class Post(FBObject):
    table_name = "Post"
    title: str = ""
    view_count: int = 0
    active: bool = True

# Create
post = Post(title="Hello", active=True)
post.save()

# Query
results = FBQuery(Post).equal_to("active", True).order("-created_at").limit(20).find()

# User login
user = FBUser.login("[e-mail]", "password123")

# File upload
fb_file = FBFile.upload("photo.jpg")
print(fb_file.url)

# AI chat
response = FBAI.chat("Hello!")
print(response.content)

Features

Class	Description
FreelyBase	Global client & HTTP
FBObject	Data model base class
FBQuery	Query builder with geo, time, cache
FBUser	Auth: register, login, third-party
FBFile	File upload & URL resolution
FBGeoPoint	Geo coordinates & distance
FBLiveQuery	Real-time WebSocket listener
FBAI	AI chat (streaming & non-streaming)