synapcores 0.2.0__tar.gz

synapcores-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 SynapCores
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

synapcores-0.2.0/PKG-INFO

@@ -0,0 +1,249 @@
+Metadata-Version: 2.4
+Name: synapcores
+Version: 0.2.0
+Summary: Official Python SDK for SynapCores AI-Native Database
+Author-email: SynapCores <release@synapcores.com>
+Maintainer-email: SynapCores <release@synapcores.com>
+License: MIT
+Project-URL: Homepage, https://synapcores.com
+Project-URL: Documentation, https://synapcores.com/developers
+Project-URL: Source, https://github.com/SynapCores/synapcores-releases
+Project-URL: Issues, https://github.com/SynapCores/synapcores-releases/issues
+Keywords: database,ai,ml,vector,embedding,semantic
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Database
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+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
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.24.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: numpy>=1.21.0
+Requires-Dist: pandas>=1.3.0
+Requires-Dist: python-dateutil>=2.8.0
+Requires-Dist: websockets>=11.0
+Requires-Dist: typing-extensions>=4.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: sphinx>=6.0.0; extra == "dev"
+Dynamic: license-file
+
+# SynapCores Python SDK
+
+Official Python SDK for SynapCores - The AI-Native Database Management System.
+
+> **0.2.0 — gateway v1.5.0-ce alignment.** This release rewires every
+> module against the v1.5.0-ce route surface. AutoML moved from `/ai/*`
+> to `/automl/*`, vector ops collapsed onto `/vector-algebra/operation`,
+> WebSocket auth now uses ticket exchange, API keys are sent via the
+> `X-API-Key` header (and accept the new `ak_*` prefix in addition to
+> the legacy `aidb_*`), and we ship new top-level modules: `graph`,
+> `nl2sql`, `filesystem`, `chat`, `multimodal`, `system`,
+> `transactions`, `mcp`, `recipes`, and `schema`.
+
+## What's new in 0.2.0
+
+```python
+from synapcores import SynapCores
+
+client = SynapCores(host="localhost", port=8080, api_key="ak_prod_xxx...")
+
+# 1. Cypher-style graph traversal
+friends = client.graph.cypher(
+    "MATCH (u:User {id:$id})-[:FRIEND]->(f) RETURN f",
+    {"id": "u-123"},
+)
+
+# 2. Natural language → SQL (with optional execution)
+ans = client.nl2sql.ask(
+    "top 10 customers by revenue this quarter",
+    execute=True,
+)
+print(ans["sql"], ans.get("rows"))
+
+# 3. AI chat sessions with streaming
+session = client.chat.sessions.create(model="gpt-4o")
+for chunk in client.chat.stream(session["id"], "Summarize today's alerts"):
+    if chunk.get("delta"):
+        print(chunk["delta"], end="", flush=True)
+
+# 4. Filesystem-backed RAG collections with progress
+fs = client.filesystem.collections.create(name="docs", path="/data/docs", watch=True)
+for evt in client.filesystem.collections.subscribe_progress(fs["id"]):
+    print(evt.get("status"), evt.get("progress"), evt.get("filename"))
+
+# 5. Server-side transactions with savepoints
+with client.transactions.begin(isolation_level="SERIALIZABLE") as tx:
+    tx.execute("UPDATE accounts SET balance = balance - $1 WHERE id = $2", [100, "a"])
+    tx.savepoint("mid")
+    tx.execute("UPDATE accounts SET balance = balance + $1 WHERE id = $2", [100, "b"])
+    # commit() runs implicitly on clean exit; rollback() on exception.
+```
+
+Other new surfaces:
+
+- `client.multimodal.{similarity,search,join,embed}` for cross-modal retrieval.
+- `client.system.vision.{get,set,delete,test}` for the admin vision config.
+- `client.mcp.{invoke,batch,info}` for the Model Context Protocol gateway.
+- `client.recipes.list_categories()/list_templates()/execute_template()/list_executions()`.
+- `client.schema.list_databases()/preview_table()`.
+
+### Breaking changes vs 0.1.0
+
+- `embed()` routes to `/ai/embeddings` (single) or `/ai/embeddings/batch`.
+- `automl.*` paths moved from `/ai/*` to `/automl/*`.
+- All vector math goes through `POST /vector-algebra/operation` with an `op` discriminator.
+- KNN/range/hybrid search routes to `/vectors/collections/:name/search` with a `mode` field.
+- API keys are sent as the `X-API-Key` header (was previously `Authorization: Bearer`).
+- WebSocket subscriptions now use ticket exchange via `POST /v1/ws/ticket` and connect to `/ws?token=...`.
+- `nlp.analyze()` is implemented client-side as parallel calls to `/ai/sentiment`, `/ai/entities`, and `/ai/summarize` since `/ai/analyze` was removed.
+- The `client.sql(query, params=...)` payload now matches `POST /v1/query/execute` (positional `parameters`); `params` is still accepted as a dict for backwards compatibility.
+
+## Features
+
+- **AI-Native Operations**: Built-in support for embeddings, vector search, and semantic analysis
+- **Document & Vector Storage**: Seamlessly work with both structured and unstructured data
+- **SQL with AI Extensions**: Use familiar SQL syntax enhanced with AI operations
+- **Real-time Subscriptions**: WebSocket support for live data updates
+- **AutoML Integration**: Automated machine learning model training and deployment
+- **Type-Safe**: Full type hints and Pydantic models for better IDE support
+
+## Installation
+
+```bash
+pip install synapcores
+```
+
+## Quick Start
+
+```python
+from synapcores import SynapCores
+
+# Initialize client with API key authentication
+# API keys can be created from your AIDB dashboard at Settings > API Keys
+# Note: API keys must start with 'aidb_' prefix
+client = SynapCores(
+    host="localhost",
+    port=8080,
+    api_key="aidb_sk_your_api_key_here"  # Replace with your actual API key
+)
+
+# Create a collection
+collection = client.create_collection(
+    name="products",
+    schema={
+        "name": "string",
+        "description": "string",
+        "price": "float",
+        "embedding": "vector[384]"
+    }
+)
+
+# Insert documents
+collection.insert([
+    {
+        "name": "Laptop",
+        "description": "High-performance laptop for developers",
+        "price": 1299.99
+    },
+    {
+        "name": "Mouse",
+        "description": "Ergonomic wireless mouse",
+        "price": 49.99
+    }
+])
+
+# Semantic search
+results = collection.search(
+    query="computer accessories",
+    top_k=5
+)
+
+# SQL with AI extensions
+df = client.sql("""
+    SELECT name, price, 
+           similarity(embedding, embed('perfect for coding')) as relevance
+    FROM products
+    WHERE price < 1500
+    ORDER BY relevance DESC
+    LIMIT 10
+""")
+
+# Real-time subscriptions
+async def handle_update(change):
+    print(f"Document {change.op}: {change.document}")
+
+subscription = await collection.subscribe(
+    filter={"price": {"$lt": 100}},
+    on_change=handle_update
+)
+```
+
+## Advanced Features
+
+### Vector Operations
+
+```python
+# Generate embeddings
+embedding = client.embed("High-quality mechanical keyboard")
+
+# Vector similarity search
+similar_products = collection.vector_search(
+    vector=embedding,
+    top_k=10,
+    filter={"price": {"$between": [50, 200]}}
+)
+```
+
+### AutoML
+
+```python
+# Train a model
+model = client.automl.train(
+    collection="sales_data",
+    target="revenue",
+    features=["product_category", "season", "price"],
+    task="regression"
+)
+
+# Make predictions
+predictions = model.predict({
+    "product_category": "electronics",
+    "season": "holiday",
+    "price": 299.99
+})
+```
+
+### NLP Analysis
+
+```python
+# Analyze text
+analysis = client.nlp.analyze(
+    text="This product exceeded my expectations. Highly recommend!",
+    tasks=["sentiment", "entities", "summary"]
+)
+
+print(f"Sentiment: {analysis.sentiment.label} ({analysis.sentiment.score})")
+print(f"Entities: {[e.text for e in analysis.entities]}")
+```
+
+## Documentation
+
+For detailed documentation, visit [https://synapcores.com/developers](https://synapcores.com/developers)
+
+## License
+
+MIT License - see LICENSE file for details.

synapcores-0.2.0/README.md

@@ -0,0 +1,206 @@
+# SynapCores Python SDK
+
+Official Python SDK for SynapCores - The AI-Native Database Management System.
+
+> **0.2.0 — gateway v1.5.0-ce alignment.** This release rewires every
+> module against the v1.5.0-ce route surface. AutoML moved from `/ai/*`
+> to `/automl/*`, vector ops collapsed onto `/vector-algebra/operation`,
+> WebSocket auth now uses ticket exchange, API keys are sent via the
+> `X-API-Key` header (and accept the new `ak_*` prefix in addition to
+> the legacy `aidb_*`), and we ship new top-level modules: `graph`,
+> `nl2sql`, `filesystem`, `chat`, `multimodal`, `system`,
+> `transactions`, `mcp`, `recipes`, and `schema`.
+
+## What's new in 0.2.0
+
+```python
+from synapcores import SynapCores
+
+client = SynapCores(host="localhost", port=8080, api_key="ak_prod_xxx...")
+
+# 1. Cypher-style graph traversal
+friends = client.graph.cypher(
+    "MATCH (u:User {id:$id})-[:FRIEND]->(f) RETURN f",
+    {"id": "u-123"},
+)
+
+# 2. Natural language → SQL (with optional execution)
+ans = client.nl2sql.ask(
+    "top 10 customers by revenue this quarter",
+    execute=True,
+)
+print(ans["sql"], ans.get("rows"))
+
+# 3. AI chat sessions with streaming
+session = client.chat.sessions.create(model="gpt-4o")
+for chunk in client.chat.stream(session["id"], "Summarize today's alerts"):
+    if chunk.get("delta"):
+        print(chunk["delta"], end="", flush=True)
+
+# 4. Filesystem-backed RAG collections with progress
+fs = client.filesystem.collections.create(name="docs", path="/data/docs", watch=True)
+for evt in client.filesystem.collections.subscribe_progress(fs["id"]):
+    print(evt.get("status"), evt.get("progress"), evt.get("filename"))
+
+# 5. Server-side transactions with savepoints
+with client.transactions.begin(isolation_level="SERIALIZABLE") as tx:
+    tx.execute("UPDATE accounts SET balance = balance - $1 WHERE id = $2", [100, "a"])
+    tx.savepoint("mid")
+    tx.execute("UPDATE accounts SET balance = balance + $1 WHERE id = $2", [100, "b"])
+    # commit() runs implicitly on clean exit; rollback() on exception.
+```
+
+Other new surfaces:
+
+- `client.multimodal.{similarity,search,join,embed}` for cross-modal retrieval.
+- `client.system.vision.{get,set,delete,test}` for the admin vision config.
+- `client.mcp.{invoke,batch,info}` for the Model Context Protocol gateway.
+- `client.recipes.list_categories()/list_templates()/execute_template()/list_executions()`.
+- `client.schema.list_databases()/preview_table()`.
+
+### Breaking changes vs 0.1.0
+
+- `embed()` routes to `/ai/embeddings` (single) or `/ai/embeddings/batch`.
+- `automl.*` paths moved from `/ai/*` to `/automl/*`.
+- All vector math goes through `POST /vector-algebra/operation` with an `op` discriminator.
+- KNN/range/hybrid search routes to `/vectors/collections/:name/search` with a `mode` field.
+- API keys are sent as the `X-API-Key` header (was previously `Authorization: Bearer`).
+- WebSocket subscriptions now use ticket exchange via `POST /v1/ws/ticket` and connect to `/ws?token=...`.
+- `nlp.analyze()` is implemented client-side as parallel calls to `/ai/sentiment`, `/ai/entities`, and `/ai/summarize` since `/ai/analyze` was removed.
+- The `client.sql(query, params=...)` payload now matches `POST /v1/query/execute` (positional `parameters`); `params` is still accepted as a dict for backwards compatibility.
+
+## Features
+
+- **AI-Native Operations**: Built-in support for embeddings, vector search, and semantic analysis
+- **Document & Vector Storage**: Seamlessly work with both structured and unstructured data
+- **SQL with AI Extensions**: Use familiar SQL syntax enhanced with AI operations
+- **Real-time Subscriptions**: WebSocket support for live data updates
+- **AutoML Integration**: Automated machine learning model training and deployment
+- **Type-Safe**: Full type hints and Pydantic models for better IDE support
+
+## Installation
+
+```bash
+pip install synapcores
+```
+
+## Quick Start
+
+```python
+from synapcores import SynapCores
+
+# Initialize client with API key authentication
+# API keys can be created from your AIDB dashboard at Settings > API Keys
+# Note: API keys must start with 'aidb_' prefix
+client = SynapCores(
+    host="localhost",
+    port=8080,
+    api_key="aidb_sk_your_api_key_here"  # Replace with your actual API key
+)
+
+# Create a collection
+collection = client.create_collection(
+    name="products",
+    schema={
+        "name": "string",
+        "description": "string",
+        "price": "float",
+        "embedding": "vector[384]"
+    }
+)
+
+# Insert documents
+collection.insert([
+    {
+        "name": "Laptop",
+        "description": "High-performance laptop for developers",
+        "price": 1299.99
+    },
+    {
+        "name": "Mouse",
+        "description": "Ergonomic wireless mouse",
+        "price": 49.99
+    }
+])
+
+# Semantic search
+results = collection.search(
+    query="computer accessories",
+    top_k=5
+)
+
+# SQL with AI extensions
+df = client.sql("""
+    SELECT name, price, 
+           similarity(embedding, embed('perfect for coding')) as relevance
+    FROM products
+    WHERE price < 1500
+    ORDER BY relevance DESC
+    LIMIT 10
+""")
+
+# Real-time subscriptions
+async def handle_update(change):
+    print(f"Document {change.op}: {change.document}")
+
+subscription = await collection.subscribe(
+    filter={"price": {"$lt": 100}},
+    on_change=handle_update
+)
+```
+
+## Advanced Features
+
+### Vector Operations
+
+```python
+# Generate embeddings
+embedding = client.embed("High-quality mechanical keyboard")
+
+# Vector similarity search
+similar_products = collection.vector_search(
+    vector=embedding,
+    top_k=10,
+    filter={"price": {"$between": [50, 200]}}
+)
+```
+
+### AutoML
+
+```python
+# Train a model
+model = client.automl.train(
+    collection="sales_data",
+    target="revenue",
+    features=["product_category", "season", "price"],
+    task="regression"
+)
+
+# Make predictions
+predictions = model.predict({
+    "product_category": "electronics",
+    "season": "holiday",
+    "price": 299.99
+})
+```
+
+### NLP Analysis
+
+```python
+# Analyze text
+analysis = client.nlp.analyze(
+    text="This product exceeded my expectations. Highly recommend!",
+    tasks=["sentiment", "entities", "summary"]
+)
+
+print(f"Sentiment: {analysis.sentiment.label} ({analysis.sentiment.score})")
+print(f"Entities: {[e.text for e in analysis.entities]}")
+```
+
+## Documentation
+
+For detailed documentation, visit [https://synapcores.com/developers](https://synapcores.com/developers)
+
+## License
+
+MIT License - see LICENSE file for details.

synapcores-0.2.0/pyproject.toml

@@ -0,0 +1,69 @@
+[build-system]
+requires = ["setuptools>=45", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "synapcores"
+version = "0.2.0"
+description = "Official Python SDK for SynapCores AI-Native Database"
+readme = "README.md"
+requires-python = ">=3.8"
+license = {text = "MIT"}
+authors = [{name = "SynapCores", email = "release@synapcores.com"}]
+maintainers = [{name = "SynapCores", email = "release@synapcores.com"}]
+keywords = ["database", "ai", "ml", "vector", "embedding", "semantic"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Topic :: Database",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "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",
+]
+
+dependencies = [
+    "httpx>=0.24.0",
+    "pydantic>=2.0.0",
+    "numpy>=1.21.0",
+    "pandas>=1.3.0",
+    "python-dateutil>=2.8.0",
+    "websockets>=11.0",
+    "typing-extensions>=4.0.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-asyncio>=0.21.0",
+    "pytest-cov>=4.0.0",
+    "black>=23.0.0",
+    "flake8>=6.0.0",
+    "mypy>=1.0.0",
+    "sphinx>=6.0.0",
+]
+
+[project.urls]
+Homepage = "https://synapcores.com"
+Documentation = "https://synapcores.com/developers"
+Source = "https://github.com/SynapCores/synapcores-releases"
+Issues = "https://github.com/SynapCores/synapcores-releases/issues"
+
+[tool.black]
+line-length = 88
+target-version = ['py38', 'py39', 'py310', 'py311', 'py312']
+
+[tool.mypy]
+python_version = "3.8"
+warn_return_any = true
+warn_unused_configs = true
+disallow_untyped_defs = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py", "*_test.py"]
+addopts = "--strict-markers --cov=synapcores"

synapcores-0.2.0/setup.cfg

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

synapcores-0.2.0/setup.py

@@ -0,0 +1,8 @@
+# All packaging metadata lives in pyproject.toml (PEP 621). This file
+# remains only as a compatibility shim for legacy tooling that still
+# invokes `python setup.py …` directly. It must not duplicate fields
+# from pyproject.toml — duplicates cause stale `Author:` /
+# `Home-page:` lines to leak into the wheel METADATA.
+from setuptools import setup
+
+setup()

synapcores-0.2.0/synapcores/__init__.py

@@ -0,0 +1,142 @@
+"""
+SynapCores Python SDK
+
+Official Python SDK for SynapCores AI-Native Database Management System.
+"""
+
+from .client import SynapCores
+from .collection import Collection
+from .exceptions import (
+    SynapCoresError,
+    ConnectionError,
+    AuthenticationError,
+    ValidationError,
+    NotFoundError,
+    ServerError,
+    TimeoutError,
+    RateLimitError,
+    SQLError,
+    VectorError,
+    TransactionError,
+    BatchOperationError,
+    IndexError,
+    ConstraintError,
+    PreparedStatementError,
+)
+from .models import (
+    Document,
+    QueryResult,
+    SearchResult,
+    Schema,
+    FieldType,
+    VectorSearchParams,
+    SubscriptionEvent,
+    # SQL Operation Models
+    ColumnDefinition,
+    CreateTableOptions,
+    AlterTableOptions,
+    IndexDefinition,
+    TableInfo,
+    TransactionOptions,
+    TransactionContext,
+    BatchInsertOptions,
+    BatchUpdateOptions,
+    BatchDeleteOptions,
+    BatchResult,
+    PreparedStatement,
+    CTEDefinition,
+    WindowFunction,
+    # Vector Operation Models
+    Vector,
+    VectorArithmeticResult,
+    VectorSimilarityResult,
+    VectorMagnitudeResult,
+    VectorSearchResult,
+    KNNSearchOptions,
+    RangeSearchOptions,
+    HybridSearchOptions,
+)
+
+# v0.2.0 modules
+from .graph import GraphClient
+from .nl2sql import NL2SqlClient
+from .filesystem import FilesystemCollectionsClient
+from .chat import ChatClient
+from .multimodal import MultimodalClient
+from .system import SystemClient
+from .transactions import TransactionsClient, Tx
+from .mcp import McpClient
+from .recipes import RecipeClient
+from .schema import SchemaClient
+
+__version__ = "0.2.0"
+__all__ = [
+    # Core Classes
+    "SynapCores",
+    "Collection",
+
+    # v0.2.0 sub-clients
+    "GraphClient",
+    "NL2SqlClient",
+    "FilesystemCollectionsClient",
+    "ChatClient",
+    "MultimodalClient",
+    "SystemClient",
+    "TransactionsClient",
+    "Tx",
+    "McpClient",
+    "RecipeClient",
+    "SchemaClient",
+
+    # Models
+    "Document",
+    "QueryResult",
+    "SearchResult",
+    "Schema",
+    "FieldType",
+    "VectorSearchParams",
+    "SubscriptionEvent",
+
+    # SQL Operation Models
+    "ColumnDefinition",
+    "CreateTableOptions",
+    "AlterTableOptions",
+    "IndexDefinition",
+    "TableInfo",
+    "TransactionOptions",
+    "TransactionContext",
+    "BatchInsertOptions",
+    "BatchUpdateOptions",
+    "BatchDeleteOptions",
+    "BatchResult",
+    "PreparedStatement",
+    "CTEDefinition",
+    "WindowFunction",
+
+    # Vector Operation Models
+    "Vector",
+    "VectorArithmeticResult",
+    "VectorSimilarityResult",
+    "VectorMagnitudeResult",
+    "VectorSearchResult",
+    "KNNSearchOptions",
+    "RangeSearchOptions",
+    "HybridSearchOptions",
+
+    # Exceptions
+    "SynapCoresError",
+    "ConnectionError",
+    "AuthenticationError",
+    "ValidationError",
+    "NotFoundError",
+    "ServerError",
+    "TimeoutError",
+    "RateLimitError",
+    "SQLError",
+    "VectorError",
+    "TransactionError",
+    "BatchOperationError",
+    "IndexError",
+    "ConstraintError",
+    "PreparedStatementError",
+]