Metadata-Version: 2.4
Name: soketdb
Version: 1.0.0
Summary: SoketDB — a zero-setup, AI-smart JSON database built for developers who value speed, simplicity, and offline capability.
Home-page: https://github.com/pythos-team/soketdb
Author: Alex Austin
Author-email: Alex Austin <benmap40@gmail.com>
License: MIT
Project-URL: Homepage, https://github.com/pythos-team/soketdb
Project-URL: Bug Tracker, https://github.com/pythos-team/soketdb/issues
Keywords: database,json,sql,ai,offline,lightweight,huggingface,google-drive,cloud-sync
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Operating System :: OS Independent
Classifier: Topic :: Database
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: huggingface_hub
Requires-Dist: sqlparse
Requires-Dist: requests
Requires-Dist: redis
Requires-Dist: dropbox
Requires-Dist: boto3
Requires-Dist: google-auth-oauthlib
Requires-Dist: google-auth-httplib2
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# ⚡ SoketDB v1 — Zero-Setup, AI-Smart JSON Database

> **No switch to turn on.**  
> SoketDB is a lightweight, offline-first, AI-powered database that runs instantly — no setup, no dependencies, no servers.

---

## 🧠 Overview

SoketDB is a **plug-and-play JSON database** with an **AI-driven query engine**.  
It lets you store, query, and sync data locally or in the cloud — without needing MySQL, PostgreSQL, or MongoDB.

Built for **developers who just want to build**, SoketDB merges the simplicity of JSON with the power of SQL and AI.

---

## 🚀 Features

- ⚡ **Zero Setup** — Works out of the box, no installations or daemons.  
- 💾 **JSON-Native Storage** — Every table is a readable JSON file.  
- 🧠 **AI Query Engine** — Translate natural language into SQL-like commands.  
- ☁️ **Cloud Backup** — Optional sync to Hugging Face, Google Drive, Dropbox, or AWS S3.  
- 🔐 **Thread-Safe Execution** — Prevents corruption in multi-threaded access.  
- 🧩 **Configurable Storage** — Local, hybrid, or full cloud mode.  
- 🧱 **System Tables** — Built-in logs, meta tracking, and analytics support.  
- 🌍 **Offline-First Philosophy** — Works anywhere, even without the internet.

---

## 🧰 Installation

```bash
pip install soketdb

Or install manually:

git clone https://github.com/alexaustindev/soketdb.git
cd soketdb
python setup.py install


---

🏁 Quick Start

from soketdb import database

# Initialize a new or existing SoketDB project
db = database("my_project")

# Create a table
db.execute("CREATE TABLE users (username TEXT, password TEXT)")

# Insert records
db.execute("""
INSERT INTO users DATA=[
  {"username": "alex", "password": "1234"},
  {"username": "ben", "password": "abcd"}
]
""")

# Query users
print(db.execute("SELECT username FROM users WHERE password='1234'"))


---

💡 Natural Language Queries

db.query("show all users where password is 1234")

✅ AI converts this into:

SELECT * FROM users WHERE password='1234'


---

☁️ Cloud Sync Example

db = database(
    "my_project",
    storage="huggingface",
    token="hf_xxx_your_token",
    path="alex/soketdb_storage"
)

You can also use Google Drive or Dropbox for automatic backups.


---

📊 Folder Structure

my_project/
│
├── users.json
├── plugins.json
├── system_meta.json
└── logs/


---

🧩 Supported Commands

Command	Description

CREATE TABLE	Create a new table
INSERT INTO	Add new JSON data
SELECT	Query records
UPDATE	Modify existing records
DELETE FROM	Delete specific rows
DROP TABLE	Remove a table completely



---

💬 Philosophy

> “Databases shouldn’t require a switch to turn on.
SoketDB runs, stores, and syncs — instantly.”
— Alex Austin, Creator of SoketDB




---

🧱 Use Cases

Offline-first or hybrid AI projects

Local testing without cloud DBs

Quick data persistence for tools, bots, or microservices

Lightweight web apps and scripts

AI/ML experiments needing quick storage



---

🔐 License

Licensed under the MIT License.
Copyright © 2025 Alex Austin


---

🌟 Tagline

> SoketDB — Simple. Smart. Secure.
The database that runs even when everything else is off.



---
