yukisdb 1.0.0__tar.gz

yukisdb-1.0.0/PKG-INFO

@@ -0,0 +1,182 @@
+Metadata-Version: 2.4
+Name: yukisdb
+Version: 1.0.0
+Summary: Official Python SDK & CLI for YukisDB — Unified Cloud NoSQL Database, 2GB Storage & AI Vector BaaS
+Home-page: https://yukisdb.yukiapi.site
+Author: SUDEEPBOTS
+Author-email: support@yukiapi.site
+Project-URL: Documentation, https://yukisdb.yukiapi.site/docs
+Project-URL: Source, https://github.com/SUDEEPBOTS/yukisdb
+Project-URL: Tracker, https://github.com/SUDEEPBOTS/yukisdb/issues
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Database
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# YukisDB Python SDK & CLI ⚡
+
+[![PyPI version](https://img.shields.io/pypi/v/yukisdb.svg)](https://pypi.org/project/yukisdb/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Official Python SDK & Developer CLI for **[YukisDB](https://yukisdb.yukiapi.site)** — Unified Cloud NoSQL JSON Document Database, 2GB Object Storage with Zero Egress Bandwidth Bills, and AI Vector Embeddings Memory.
+
+---
+
+## 📦 Installation
+
+```bash
+pip install yukisdb
+```
+
+---
+
+## 💻 CLI Quickstart
+
+Once installed, the `yukisdb` command is immediately available in your terminal:
+
+```bash
+# Check cluster telemetry & health
+yukisdb health
+
+# View developer free tier quotas
+yukisdb tier
+
+# Zero-auth sandbox insert
+yukisdb sandbox insert '{"task": "test", "completed": true}'
+
+# Zero-auth sandbox query
+yukisdb sandbox find '{"completed": true}'
+
+# Generate an ephemeral API testing key
+yukisdb anonymous-key
+
+# Authenticated CRUD (requires export YUKISDB_API_KEY=ydb_live_...)
+export YUKISDB_API_KEY="ydb_live_your_key_here"
+yukisdb insert users '{"name": "Sudeep", "role": "admin"}'
+yukisdb find users '{"role": "admin"}'
+yukisdb upload model_checkpoint.pt
+```
+
+---
+
+## 🐍 Python SDK Quickstart
+
+### 1. Initialize Client
+
+```python
+from yukisdb import YukisDB
+
+# Automatically picks up YUKISDB_API_KEY environment variable if omitted
+db = YukisDB(api_key="ydb_live_your_api_key_here")
+```
+
+### 2. NoSQL Document Operations (CRUD)
+
+```python
+# Insert a document
+doc = db.collection("users").insert({
+    "name": "Alice",
+    "email": "alice@example.com",
+    "tier": "developer"
+})
+print("Inserted ID:", doc["id"])
+
+# Query documents
+users = db.collection("users").find({"tier": "developer"})
+print("Found users:", users)
+
+# Retrieve single document by ID
+user = db.collection("users").get(doc["id"])
+
+# Update document
+db.collection("users").update(doc["id"], {"tier": "pro"})
+
+# Delete document
+db.collection("users").delete(doc["id"])
+```
+
+### 3. AI Vector Embeddings Search
+
+```python
+# Cosine similarity nearest-neighbor search for agent long-term memory
+results = db.collection("agent_memory").vector_search(
+    vector=[0.12, -0.45, 0.88, 0.05],
+    field="embedding",
+    top_k=5
+)
+for match in results:
+    print(match["title"], match["_score"])
+```
+
+### 4. 2GB Object Storage (Zero Egress Bills)
+
+```python
+# Upload any file up to 2GB with instant CDN streaming URL
+file_info = db.storage.upload("video_dataset.mp4", custom_slug="dataset-2026")
+print("Public CDN URL:", file_info["url"])
+
+# List tenant storage files
+files = db.storage.list()
+print("Storage objects:", files)
+```
+
+### 5. Zero-Auth Public Sandbox (Prototyping)
+
+```python
+# Store without registration
+sandbox_doc = db.sandbox.insert({"experiment": "RAG pipeline test"})
+print("Saved to sandbox:", sandbox_doc)
+```
+
+---
+
+## 🤖 Model Context Protocol (MCP) Integration
+
+YukisDB runs a native Model Context Protocol (MCP 2024-11-05) server for Claude Desktop, Cursor AI, and autonomous agents:
+
+```json
+{
+  "mcpServers": {
+    "yukisdb": {
+      "command": "yukisdb",
+      "args": ["mcp"],
+      "env": {
+        "YUKISDB_API_KEY": "ydb_live_your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+Or connect directly to Streamable HTTP: `https://yukisdb.yukiapi.site/mcp`.
+
+---
+
+## 🔗 Resources
+
+- **Website & Portal:** [https://yukisdb.yukiapi.site](https://yukisdb.yukiapi.site)
+- **Developer Documentation:** [https://yukisdb.yukiapi.site/docs](https://yukisdb.yukiapi.site/docs)
+- **OpenAPI 3.1 Spec:** [https://yukisdb.yukiapi.site/openapi.json](https://yukisdb.yukiapi.site/openapi.json)
+- **LLMs Knowledge Reference:** [https://yukisdb.yukiapi.site/llms.txt](https://yukisdb.yukiapi.site/llms.txt)
+- **Support & Security:** `support@yukiapi.site`

yukisdb-1.0.0/README.md

@@ -0,0 +1,146 @@
+# YukisDB Python SDK & CLI ⚡
+
+[![PyPI version](https://img.shields.io/pypi/v/yukisdb.svg)](https://pypi.org/project/yukisdb/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Official Python SDK & Developer CLI for **[YukisDB](https://yukisdb.yukiapi.site)** — Unified Cloud NoSQL JSON Document Database, 2GB Object Storage with Zero Egress Bandwidth Bills, and AI Vector Embeddings Memory.
+
+---
+
+## 📦 Installation
+
+```bash
+pip install yukisdb
+```
+
+---
+
+## 💻 CLI Quickstart
+
+Once installed, the `yukisdb` command is immediately available in your terminal:
+
+```bash
+# Check cluster telemetry & health
+yukisdb health
+
+# View developer free tier quotas
+yukisdb tier
+
+# Zero-auth sandbox insert
+yukisdb sandbox insert '{"task": "test", "completed": true}'
+
+# Zero-auth sandbox query
+yukisdb sandbox find '{"completed": true}'
+
+# Generate an ephemeral API testing key
+yukisdb anonymous-key
+
+# Authenticated CRUD (requires export YUKISDB_API_KEY=ydb_live_...)
+export YUKISDB_API_KEY="ydb_live_your_key_here"
+yukisdb insert users '{"name": "Sudeep", "role": "admin"}'
+yukisdb find users '{"role": "admin"}'
+yukisdb upload model_checkpoint.pt
+```
+
+---
+
+## 🐍 Python SDK Quickstart
+
+### 1. Initialize Client
+
+```python
+from yukisdb import YukisDB
+
+# Automatically picks up YUKISDB_API_KEY environment variable if omitted
+db = YukisDB(api_key="ydb_live_your_api_key_here")
+```
+
+### 2. NoSQL Document Operations (CRUD)
+
+```python
+# Insert a document
+doc = db.collection("users").insert({
+    "name": "Alice",
+    "email": "alice@example.com",
+    "tier": "developer"
+})
+print("Inserted ID:", doc["id"])
+
+# Query documents
+users = db.collection("users").find({"tier": "developer"})
+print("Found users:", users)
+
+# Retrieve single document by ID
+user = db.collection("users").get(doc["id"])
+
+# Update document
+db.collection("users").update(doc["id"], {"tier": "pro"})
+
+# Delete document
+db.collection("users").delete(doc["id"])
+```
+
+### 3. AI Vector Embeddings Search
+
+```python
+# Cosine similarity nearest-neighbor search for agent long-term memory
+results = db.collection("agent_memory").vector_search(
+    vector=[0.12, -0.45, 0.88, 0.05],
+    field="embedding",
+    top_k=5
+)
+for match in results:
+    print(match["title"], match["_score"])
+```
+
+### 4. 2GB Object Storage (Zero Egress Bills)
+
+```python
+# Upload any file up to 2GB with instant CDN streaming URL
+file_info = db.storage.upload("video_dataset.mp4", custom_slug="dataset-2026")
+print("Public CDN URL:", file_info["url"])
+
+# List tenant storage files
+files = db.storage.list()
+print("Storage objects:", files)
+```
+
+### 5. Zero-Auth Public Sandbox (Prototyping)
+
+```python
+# Store without registration
+sandbox_doc = db.sandbox.insert({"experiment": "RAG pipeline test"})
+print("Saved to sandbox:", sandbox_doc)
+```
+
+---
+
+## 🤖 Model Context Protocol (MCP) Integration
+
+YukisDB runs a native Model Context Protocol (MCP 2024-11-05) server for Claude Desktop, Cursor AI, and autonomous agents:
+
+```json
+{
+  "mcpServers": {
+    "yukisdb": {
+      "command": "yukisdb",
+      "args": ["mcp"],
+      "env": {
+        "YUKISDB_API_KEY": "ydb_live_your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+Or connect directly to Streamable HTTP: `https://yukisdb.yukiapi.site/mcp`.
+
+---
+
+## 🔗 Resources
+
+- **Website & Portal:** [https://yukisdb.yukiapi.site](https://yukisdb.yukiapi.site)
+- **Developer Documentation:** [https://yukisdb.yukiapi.site/docs](https://yukisdb.yukiapi.site/docs)
+- **OpenAPI 3.1 Spec:** [https://yukisdb.yukiapi.site/openapi.json](https://yukisdb.yukiapi.site/openapi.json)
+- **LLMs Knowledge Reference:** [https://yukisdb.yukiapi.site/llms.txt](https://yukisdb.yukiapi.site/llms.txt)
+- **Support & Security:** `support@yukiapi.site`

yukisdb-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

yukisdb-1.0.0/setup.py

@@ -0,0 +1,44 @@
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="yukisdb",
+    version="1.0.0",
+    description="Official Python SDK & CLI for YukisDB — Unified Cloud NoSQL Database, 2GB Storage & AI Vector BaaS",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    author="SUDEEPBOTS",
+    author_email="support@yukiapi.site",
+    url="https://yukisdb.yukiapi.site",
+    project_urls={
+        "Documentation": "https://yukisdb.yukiapi.site/docs",
+        "Source": "https://github.com/SUDEEPBOTS/yukisdb",
+        "Tracker": "https://github.com/SUDEEPBOTS/yukisdb/issues",
+    },
+    packages=find_packages(),
+    entry_points={
+        "console_scripts": [
+            "yukisdb=yukisdb.cli:main",
+        ],
+    },
+    install_requires=[
+        "requests>=2.25.0",
+    ],
+    python_requires=">=3.8",
+    classifiers=[
+        "Development Status :: 5 - Production/Stable",
+        "Intended Audience :: Developers",
+        "Topic :: Database",
+        "Topic :: Software Development :: Libraries :: Python Modules",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+        "Programming Language :: Python :: 3.8",
+        "Programming Language :: Python :: 3.9",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "Operating System :: OS Independent",
+    ],
+)

yukisdb-1.0.0/yukisdb/__init__.py

@@ -0,0 +1,11 @@
+"""
+⚡ YukisDB Official Python SDK & CLI
+Unified Cloud NoSQL Document Database, 2GB Object Storage & AI Vector Search BaaS
+https://yukisdb.yukiapi.site
+"""
+
+from .client import YukisDB, Collection, Storage, Sandbox
+from .cli import main as cli_main
+
+__version__ = "1.0.0"
+__all__ = ["YukisDB", "Collection", "Storage", "Sandbox", "cli_main"]

yukisdb-1.0.0/yukisdb/cli.py

@@ -0,0 +1,180 @@
+"""
+YukisDB Official Developer CLI
+https://yukisdb.yukiapi.site
+"""
+
+import sys
+import os
+import json
+import urllib.request
+import urllib.parse
+import urllib.error
+
+API_HOST = os.getenv("YUKISDB_HOST", "https://yukisdb.yukiapi.site").rstrip("/")
+API_KEY = os.getenv("YUKISDB_API_KEY", "")
+
+def get_headers():
+    hdrs = {"User-Agent": "YukisDB-CLI/1.0.0"}
+    if API_KEY:
+        hdrs["Authorization"] = f"Bearer {API_KEY}"
+        hdrs["X-API-Key"] = API_KEY
+    return hdrs
+
+def print_help():
+    print("""⚡ YukisDB Official Developer CLI v1.0.0 (yukiapi.site)
+Portal & Documentation: https://yukisdb.yukiapi.site/docs
+
+Usage:
+  yukisdb health                             Check Singapore cluster health
+  yukisdb tier                               View developer free tier quotas
+  yukisdb insert <collection> <json-data>    Insert document into collection
+  yukisdb find <collection> [json-query]     Query collection documents
+  yukisdb get <collection> <doc-id>          Get single document by ID
+  yukisdb update <col> <id> <json-data>      Update document by ID
+  yukisdb delete <collection> <doc-id>       Delete document by ID
+  yukisdb upload <filepath> [custom-slug]    Upload file to 2GB Object Storage
+  yukisdb list-files                         List uploaded storage objects
+  yukisdb sandbox insert <json-data>         Zero-auth test document insert
+  yukisdb sandbox find [json-query]          Zero-auth test document query
+  yukisdb anonymous-key                      Generate instant ephemeral test key
+  yukisdb mcp                                Run local MCP stdio server bridge
+""")
+
+def main():
+    global API_HOST, API_KEY
+    if len(sys.argv) < 2 or sys.argv[1] in ["-h", "--help", "help"]:
+        print_help()
+        return
+
+    cmd = sys.argv[1]
+
+    try:
+        if cmd == "health":
+            req = urllib.request.Request(f"{API_HOST}/api/v1/health", headers=get_headers())
+            with urllib.request.urlopen(req) as res:
+                print(json.dumps(json.loads(res.read().decode()), indent=2))
+
+        elif cmd == "tier":
+            req = urllib.request.Request(f"{API_HOST}/api/v1/public/tier", headers=get_headers())
+            with urllib.request.urlopen(req) as res:
+                print(json.dumps(json.loads(res.read().decode()), indent=2))
+
+        elif cmd == "anonymous-key":
+            req = urllib.request.Request(f"{API_HOST}/api/v1/auth/anonymous-key", method="POST", headers=get_headers())
+            with urllib.request.urlopen(req) as res:
+                print(json.dumps(json.loads(res.read().decode()), indent=2))
+
+        elif cmd == "sandbox":
+            if len(sys.argv) < 3:
+                print("Usage: yukisdb sandbox insert <json> | yukisdb sandbox find [json]")
+                return
+            subcmd = sys.argv[2]
+            if subcmd == "insert" and len(sys.argv) >= 4:
+                payload = json.loads(sys.argv[3])
+                req = urllib.request.Request(
+                    f"{API_HOST}/api/v1/sandbox/insert",
+                    data=json.dumps(payload).encode(),
+                    headers={**get_headers(), "Content-Type": "application/json"},
+                    method="POST"
+                )
+                with urllib.request.urlopen(req) as res:
+                    print(json.dumps(json.loads(res.read().decode()), indent=2))
+            elif subcmd == "find":
+                query = json.loads(sys.argv[3]) if len(sys.argv) >= 4 else {}
+                req = urllib.request.Request(
+                    f"{API_HOST}/api/v1/sandbox/find",
+                    data=json.dumps(query).encode(),
+                    headers={**get_headers(), "Content-Type": "application/json"},
+                    method="POST"
+                )
+                with urllib.request.urlopen(req) as res:
+                    print(json.dumps(json.loads(res.read().decode()), indent=2))
+
+        elif cmd == "insert" and len(sys.argv) >= 4:
+            col = sys.argv[2]
+            data = json.loads(sys.argv[3])
+            req = urllib.request.Request(
+                f"{API_HOST}/api/v1/db/{col}/insert",
+                data=json.dumps(data).encode(),
+                headers={**get_headers(), "Content-Type": "application/json"},
+                method="POST"
+            )
+            with urllib.request.urlopen(req) as res:
+                print(json.dumps(json.loads(res.read().decode()), indent=2))
+
+        elif cmd == "find" and len(sys.argv) >= 3:
+            col = sys.argv[2]
+            query = json.loads(sys.argv[3]) if len(sys.argv) >= 4 else {}
+            req = urllib.request.Request(
+                f"{API_HOST}/api/v1/db/{col}/find",
+                data=json.dumps(query).encode(),
+                headers={**get_headers(), "Content-Type": "application/json"},
+                method="POST"
+            )
+            with urllib.request.urlopen(req) as res:
+                print(json.dumps(json.loads(res.read().decode()), indent=2))
+
+        elif cmd == "get" and len(sys.argv) >= 4:
+            col = sys.argv[2]
+            doc_id = sys.argv[3]
+            req = urllib.request.Request(f"{API_HOST}/api/v1/db/{col}/{doc_id}", headers=get_headers())
+            with urllib.request.urlopen(req) as res:
+                print(json.dumps(json.loads(res.read().decode()), indent=2))
+
+        elif cmd == "update" and len(sys.argv) >= 5:
+            col = sys.argv[2]
+            doc_id = sys.argv[3]
+            data = json.loads(sys.argv[4])
+            req = urllib.request.Request(
+                f"{API_HOST}/api/v1/db/{col}/{doc_id}",
+                data=json.dumps(data).encode(),
+                headers={**get_headers(), "Content-Type": "application/json"},
+                method="PUT"
+            )
+            with urllib.request.urlopen(req) as res:
+                print(json.dumps(json.loads(res.read().decode()), indent=2))
+
+        elif cmd == "delete" and len(sys.argv) >= 4:
+            col = sys.argv[2]
+            doc_id = sys.argv[3]
+            req = urllib.request.Request(f"{API_HOST}/api/v1/db/{col}/{doc_id}", headers=get_headers(), method="DELETE")
+            with urllib.request.urlopen(req) as res:
+                print(json.dumps(json.loads(res.read().decode()), indent=2))
+
+        elif cmd == "list-files":
+            req = urllib.request.Request(f"{API_HOST}/api/v1/storage/files", headers=get_headers())
+            with urllib.request.urlopen(req) as res:
+                print(json.dumps(json.loads(res.read().decode()), indent=2))
+
+        elif cmd == "mcp":
+            while True:
+                line = sys.stdin.readline()
+                if not line:
+                    break
+                try:
+                    rpc_req = json.loads(line.strip())
+                    req = urllib.request.Request(
+                        f"{API_HOST}/mcp",
+                        data=json.dumps(rpc_req).encode(),
+                        headers={**get_headers(), "Content-Type": "application/json"},
+                        method="POST"
+                    )
+                    with urllib.request.urlopen(req) as res:
+                        sys.stdout.write(res.read().decode() + "\n")
+                        sys.stdout.flush()
+                except Exception as e:
+                    err_resp = {"jsonrpc": "2.0", "id": None, "error": {"code": -32603, "message": str(e)}}
+                    sys.stdout.write(json.dumps(err_resp) + "\n")
+                    sys.stdout.flush()
+        else:
+            print_help()
+
+    except urllib.error.HTTPError as he:
+        print(f"Error [{he.code}]: {he.read().decode()}", file=sys.stderr)
+        sys.exit(1)
+    except Exception as ex:
+        print(f"Error: {ex}", file=sys.stderr)
+        sys.exit(1)
+
+if __name__ == "__main__":
+    main()

yukisdb-1.0.0/yukisdb/client.py

@@ -0,0 +1,170 @@
+"""
+YukisDB Official Python SDK
+https://yukisdb.yukiapi.site
+"""
+
+import os
+import json
+import requests
+from typing import Dict, Any, List, Optional, Union
+
+DEFAULT_HOST = "https://yukisdb.yukiapi.site"
+
+class Collection:
+    def __init__(self, client: "YukisDB", name: str):
+        self.client = client
+        self.name = name
+
+    def insert(self, document: Dict[str, Any]) -> Dict[str, Any]:
+        """Insert a JSON document into the collection."""
+        url = f"{self.client.base_url}/api/v1/db/{self.name}/insert"
+        resp = requests.post(url, json=document, headers=self.client.headers)
+        if resp.status_code != 200:
+            raise Exception(f"YukisDB Insert Error [{resp.status_code}]: {resp.text}")
+        return resp.json()
+
+    def find(self, query: Optional[Dict[str, Any]] = None, limit: int = 50) -> List[Dict[str, Any]]:
+        """Query documents from the collection matching the filter."""
+        url = f"{self.client.base_url}/api/v1/db/{self.name}/find"
+        resp = requests.post(url, json=query or {}, headers=self.client.headers, params={"limit": limit})
+        if resp.status_code != 200:
+            raise Exception(f"YukisDB Find Error [{resp.status_code}]: {resp.text}")
+        return resp.json()
+
+    def get(self, doc_id: str) -> Optional[Dict[str, Any]]:
+        """Retrieve a document by its unique ID."""
+        url = f"{self.client.base_url}/api/v1/db/{self.name}/{doc_id}"
+        resp = requests.get(url, headers=self.client.headers)
+        if resp.status_code == 404:
+            return None
+        if resp.status_code != 200:
+            raise Exception(f"YukisDB Get Error [{resp.status_code}]: {resp.text}")
+        return resp.json()
+
+    def update(self, doc_id: str, update_data: Dict[str, Any]) -> Dict[str, Any]:
+        """Update fields of an existing document."""
+        url = f"{self.client.base_url}/api/v1/db/{self.name}/{doc_id}"
+        resp = requests.put(url, json=update_data, headers=self.client.headers)
+        if resp.status_code != 200:
+            raise Exception(f"YukisDB Update Error [{resp.status_code}]: {resp.text}")
+        return resp.json()
+
+    def delete(self, doc_id: str) -> bool:
+        """Delete a document by ID."""
+        url = f"{self.client.base_url}/api/v1/db/{self.name}/{doc_id}"
+        resp = requests.delete(url, headers=self.client.headers)
+        if resp.status_code == 200:
+            return True
+        if resp.status_code == 404:
+            return False
+        raise Exception(f"YukisDB Delete Error [{resp.status_code}]: {resp.text}")
+
+    def aggregate(self, pipeline: List[Dict[str, Any]]) -> List[Dict[str, Any]]:
+        """Execute a multi-stage aggregation pipeline."""
+        url = f"{self.client.base_url}/api/v1/db/{self.name}/aggregate"
+        resp = requests.post(url, json=pipeline, headers=self.client.headers)
+        if resp.status_code != 200:
+            raise Exception(f"YukisDB Aggregate Error [{resp.status_code}]: {resp.text}")
+        return resp.json()
+
+    def vector_search(self, vector: List[float], field: str = "embedding", top_k: int = 5) -> List[Dict[str, Any]]:
+        """Execute cosine similarity vector search for AI semantic context."""
+        url = f"{self.client.base_url}/api/v1/db/{self.name}/vector-search"
+        payload = {"vector": vector, "field": field, "top_k": top_k}
+        resp = requests.post(url, json=payload, headers=self.client.headers)
+        if resp.status_code != 200:
+            raise Exception(f"YukisDB Vector Search Error [{resp.status_code}]: {resp.text}")
+        return resp.json()
+
+
+class Storage:
+    def __init__(self, client: "YukisDB"):
+        self.client = client
+
+    def upload(self, file_path_or_bytes: Union[str, bytes], filename: Optional[str] = None, custom_slug: Optional[str] = None) -> Dict[str, Any]:
+        """Upload a file or multimedia object (up to 2GB) to YukisDB Object Storage."""
+        url = f"{self.client.base_url}/api/v1/storage/upload"
+        headers = {"X-API-Key": self.client.api_key} if self.client.api_key else {}
+        data = {"custom_slug": custom_slug} if custom_slug else {}
+
+        if isinstance(file_path_or_bytes, str):
+            fname = filename or os.path.basename(file_path_or_bytes)
+            with open(file_path_or_bytes, "rb") as f:
+                files = {"file": (fname, f)}
+                resp = requests.post(url, files=files, data=data, headers=headers)
+        else:
+            fname = filename or "upload.bin"
+            files = {"file": (fname, file_path_or_bytes)}
+            resp = requests.post(url, files=files, data=data, headers=headers)
+
+        if resp.status_code != 200:
+            raise Exception(f"YukisDB Storage Upload Error [{resp.status_code}]: {resp.text}")
+        return resp.json()
+
+    def list(self) -> List[Dict[str, Any]]:
+        """List all stored objects."""
+        url = f"{self.client.base_url}/api/v1/storage/files"
+        resp = requests.get(url, headers=self.client.headers)
+        if resp.status_code != 200:
+            raise Exception(f"YukisDB Storage List Error [{resp.status_code}]: {resp.text}")
+        return resp.json()
+
+
+class Sandbox:
+    def __init__(self, client: "YukisDB"):
+        self.client = client
+
+    def insert(self, document: Dict[str, Any]) -> Dict[str, Any]:
+        """Zero-auth test document insert."""
+        url = f"{self.client.base_url}/api/v1/sandbox/insert"
+        resp = requests.post(url, json=document, headers={"Content-Type": "application/json"})
+        if resp.status_code != 200:
+            raise Exception(f"YukisDB Sandbox Insert Error [{resp.status_code}]: {resp.text}")
+        return resp.json()
+
+    def find(self, query: Optional[Dict[str, Any]] = None) -> List[Dict[str, Any]]:
+        """Zero-auth test document query."""
+        url = f"{self.client.base_url}/api/v1/sandbox/find"
+        resp = requests.post(url, json=query or {}, headers={"Content-Type": "application/json"})
+        if resp.status_code != 200:
+            raise Exception(f"YukisDB Sandbox Find Error [{resp.status_code}]: {resp.text}")
+        return resp.json()
+
+
+class YukisDB:
+    """YukisDB Unified Database, 2GB Storage & AI Vector Memory Client."""
+    def __init__(self, api_key: Optional[str] = None, base_url: Optional[str] = None):
+        self.api_key = api_key or os.getenv("YUKISDB_API_KEY", "")
+        self.base_url = (base_url or os.getenv("YUKISDB_HOST", DEFAULT_HOST)).rstrip("/")
+        self.headers = {
+            "Content-Type": "application/json",
+            "User-Agent": "YukisDB-Python-SDK/1.0.0"
+        }
+        if self.api_key:
+            self.headers["Authorization"] = f"Bearer {self.api_key}"
+            self.headers["X-API-Key"] = self.api_key
+
+        self.storage = Storage(self)
+        self.sandbox = Sandbox(self)
+
+    def collection(self, name: str) -> Collection:
+        """Access a database collection."""
+        return Collection(self, name)
+
+    def health(self) -> Dict[str, Any]:
+        """Check cluster operational telemetry."""
+        url = f"{self.base_url}/api/v1/health"
+        resp = requests.get(url)
+        return resp.json()
+
+    def tier(self) -> Dict[str, Any]:
+        """Get developer tier specifications and quotas."""
+        url = f"{self.base_url}/api/v1/public/tier"
+        resp = requests.get(url)
+        return resp.json()
+
+    def generate_anonymous_key(self) -> Dict[str, Any]:
+        """Generate an instant ephemeral API key for testing."""
+        url = f"{self.base_url}/api/v1/auth/anonymous-key"
+        resp = requests.post(url)
+        return resp.json()

yukisdb-1.0.0/yukisdb.egg-info/PKG-INFO

@@ -0,0 +1,182 @@
+Metadata-Version: 2.4
+Name: yukisdb
+Version: 1.0.0
+Summary: Official Python SDK & CLI for YukisDB — Unified Cloud NoSQL Database, 2GB Storage & AI Vector BaaS
+Home-page: https://yukisdb.yukiapi.site
+Author: SUDEEPBOTS
+Author-email: support@yukiapi.site
+Project-URL: Documentation, https://yukisdb.yukiapi.site/docs
+Project-URL: Source, https://github.com/SUDEEPBOTS/yukisdb
+Project-URL: Tracker, https://github.com/SUDEEPBOTS/yukisdb/issues
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Database
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# YukisDB Python SDK & CLI ⚡
+
+[![PyPI version](https://img.shields.io/pypi/v/yukisdb.svg)](https://pypi.org/project/yukisdb/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Official Python SDK & Developer CLI for **[YukisDB](https://yukisdb.yukiapi.site)** — Unified Cloud NoSQL JSON Document Database, 2GB Object Storage with Zero Egress Bandwidth Bills, and AI Vector Embeddings Memory.
+
+---
+
+## 📦 Installation
+
+```bash
+pip install yukisdb
+```
+
+---
+
+## 💻 CLI Quickstart
+
+Once installed, the `yukisdb` command is immediately available in your terminal:
+
+```bash
+# Check cluster telemetry & health
+yukisdb health
+
+# View developer free tier quotas
+yukisdb tier
+
+# Zero-auth sandbox insert
+yukisdb sandbox insert '{"task": "test", "completed": true}'
+
+# Zero-auth sandbox query
+yukisdb sandbox find '{"completed": true}'
+
+# Generate an ephemeral API testing key
+yukisdb anonymous-key
+
+# Authenticated CRUD (requires export YUKISDB_API_KEY=ydb_live_...)
+export YUKISDB_API_KEY="ydb_live_your_key_here"
+yukisdb insert users '{"name": "Sudeep", "role": "admin"}'
+yukisdb find users '{"role": "admin"}'
+yukisdb upload model_checkpoint.pt
+```
+
+---
+
+## 🐍 Python SDK Quickstart
+
+### 1. Initialize Client
+
+```python
+from yukisdb import YukisDB
+
+# Automatically picks up YUKISDB_API_KEY environment variable if omitted
+db = YukisDB(api_key="ydb_live_your_api_key_here")
+```
+
+### 2. NoSQL Document Operations (CRUD)
+
+```python
+# Insert a document
+doc = db.collection("users").insert({
+    "name": "Alice",
+    "email": "alice@example.com",
+    "tier": "developer"
+})
+print("Inserted ID:", doc["id"])
+
+# Query documents
+users = db.collection("users").find({"tier": "developer"})
+print("Found users:", users)
+
+# Retrieve single document by ID
+user = db.collection("users").get(doc["id"])
+
+# Update document
+db.collection("users").update(doc["id"], {"tier": "pro"})
+
+# Delete document
+db.collection("users").delete(doc["id"])
+```
+
+### 3. AI Vector Embeddings Search
+
+```python
+# Cosine similarity nearest-neighbor search for agent long-term memory
+results = db.collection("agent_memory").vector_search(
+    vector=[0.12, -0.45, 0.88, 0.05],
+    field="embedding",
+    top_k=5
+)
+for match in results:
+    print(match["title"], match["_score"])
+```
+
+### 4. 2GB Object Storage (Zero Egress Bills)
+
+```python
+# Upload any file up to 2GB with instant CDN streaming URL
+file_info = db.storage.upload("video_dataset.mp4", custom_slug="dataset-2026")
+print("Public CDN URL:", file_info["url"])
+
+# List tenant storage files
+files = db.storage.list()
+print("Storage objects:", files)
+```
+
+### 5. Zero-Auth Public Sandbox (Prototyping)
+
+```python
+# Store without registration
+sandbox_doc = db.sandbox.insert({"experiment": "RAG pipeline test"})
+print("Saved to sandbox:", sandbox_doc)
+```
+
+---
+
+## 🤖 Model Context Protocol (MCP) Integration
+
+YukisDB runs a native Model Context Protocol (MCP 2024-11-05) server for Claude Desktop, Cursor AI, and autonomous agents:
+
+```json
+{
+  "mcpServers": {
+    "yukisdb": {
+      "command": "yukisdb",
+      "args": ["mcp"],
+      "env": {
+        "YUKISDB_API_KEY": "ydb_live_your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+Or connect directly to Streamable HTTP: `https://yukisdb.yukiapi.site/mcp`.
+
+---
+
+## 🔗 Resources
+
+- **Website & Portal:** [https://yukisdb.yukiapi.site](https://yukisdb.yukiapi.site)
+- **Developer Documentation:** [https://yukisdb.yukiapi.site/docs](https://yukisdb.yukiapi.site/docs)
+- **OpenAPI 3.1 Spec:** [https://yukisdb.yukiapi.site/openapi.json](https://yukisdb.yukiapi.site/openapi.json)
+- **LLMs Knowledge Reference:** [https://yukisdb.yukiapi.site/llms.txt](https://yukisdb.yukiapi.site/llms.txt)
+- **Support & Security:** `support@yukiapi.site`

yukisdb-1.0.0/yukisdb.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+setup.py
+yukisdb/__init__.py
+yukisdb/cli.py
+yukisdb/client.py
+yukisdb.egg-info/PKG-INFO
+yukisdb.egg-info/SOURCES.txt
+yukisdb.egg-info/dependency_links.txt
+yukisdb.egg-info/entry_points.txt
+yukisdb.egg-info/requires.txt
+yukisdb.egg-info/top_level.txt

yukisdb-1.0.0/yukisdb.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

yukisdb-1.0.0/yukisdb.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+yukisdb = yukisdb.cli:main

yukisdb-1.0.0/yukisdb.egg-info/requires.txt

@@ -0,0 +1 @@
+requests>=2.25.0

yukisdb-1.0.0/yukisdb.egg-info/top_level.txt

@@ -0,0 +1 @@
+yukisdb