synapsai-python 0.1.0__tar.gz → 0.1.2__tar.gz

{synapsai_python-0.1.0 → synapsai_python-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: synapsai-python
-Version: 0.1.0
+Version: 0.1.2
 Summary: The official SynapsAI Cloud Python SDK
 Home-page: https://github.com/synapsai-cloud/synapsai
 Author: SynapsAI Technologies Inc.
@@ -215,7 +215,8 @@ License-File: LICENSE
 Requires-Dist: httpx>=0.23.0
 Requires-Dist: pydantic<3,>=2.0
 Requires-Dist: typing-extensions>=4.5
-Requires-Dist: Pillow>=9.5.0
+Requires-Dist: Pillow>=12.2.0
+Requires-Dist: click>=8.0
 Dynamic: author
 Dynamic: home-page
 Dynamic: license-file
@@ -282,7 +283,9 @@ for model in models_page.data:
 
 ## Documentation
 
-For advanced configurations, deep-dive usage guides, and comprehensive code examples for every resource, visit our [Examples Documentation](https://docs.synapsai.cloud/examples/introduction).
+Local guides live in [`docs/`](docs/README.md) (getting started, every resource, CLI, async, errors).
+
+Online examples: [docs.synapsai.cloud](https://docs.synapsai.cloud/examples/introduction).
 
 ---
 
@@ -293,7 +296,8 @@ The SDK provides native support for the following SynapsAI Cloud capabilities:
 | Resource | Description |
 | --- | --- |
 | **`models`** | Model management and discovery |
-| **`chat.completions`** | Chat completions and real-time streaming |
+| **`chat.completions`** | Chat completions, streaming, and stored CRUD |
+| **`responses`** | Responses API create / retrieve / delete |
 | **`completions`** | Classic text completions |
 | **`embeddings`** | Text embeddings generation |
 | **`images`** | Image generation and manipulation |
@@ -304,6 +308,28 @@ The SDK provides native support for the following SynapsAI Cloud capabilities:
 | **`feature_extraction`** | Feature extraction pipelines |
 | **`fill_mask`** | Masked Language Modeling (MLM) |
 | **`rerank`** | Text reranking for search optimization |
+| **`vector_stores`** | Vector stores and file ingestion/search |
+| **`model_artifacts`** | Model artifact upload sessions |
+| **`agents`** | Persisted agent runs (AG-UI SSE) |
+
+---
+
+## CLI
+
+After install, the `synapsai` command is available:
+
+```bash
+# Upload a model directory into an existing artifact
+synapsai upload-model ./my-model --artifact-id artifact-demo-abc12345
+
+# Upload files or directories into a vector store
+synapsai upload-vector-store-files vs_abc123 ./docs ./readme.md
+```
+
+Environment variables:
+
+* `SYNAPSAI_API_KEY` — API key
+* `SYNAPSAI_API_BASE` — API base URL (default `https://api.synapsai.cloud/v1`)
 
 ---
 

{synapsai_python-0.1.0 → synapsai_python-0.1.2}/README.md

@@ -59,7 +59,9 @@ for model in models_page.data:
 
 ## Documentation
 
-For advanced configurations, deep-dive usage guides, and comprehensive code examples for every resource, visit our [Examples Documentation](https://docs.synapsai.cloud/examples/introduction).
+Local guides live in [`docs/`](docs/README.md) (getting started, every resource, CLI, async, errors).
+
+Online examples: [docs.synapsai.cloud](https://docs.synapsai.cloud/examples/introduction).
 
 ---
 
@@ -70,7 +72,8 @@ The SDK provides native support for the following SynapsAI Cloud capabilities:
 | Resource | Description |
 | --- | --- |
 | **`models`** | Model management and discovery |
-| **`chat.completions`** | Chat completions and real-time streaming |
+| **`chat.completions`** | Chat completions, streaming, and stored CRUD |
+| **`responses`** | Responses API create / retrieve / delete |
 | **`completions`** | Classic text completions |
 | **`embeddings`** | Text embeddings generation |
 | **`images`** | Image generation and manipulation |
@@ -81,6 +84,28 @@ The SDK provides native support for the following SynapsAI Cloud capabilities:
 | **`feature_extraction`** | Feature extraction pipelines |
 | **`fill_mask`** | Masked Language Modeling (MLM) |
 | **`rerank`** | Text reranking for search optimization |
+| **`vector_stores`** | Vector stores and file ingestion/search |
+| **`model_artifacts`** | Model artifact upload sessions |
+| **`agents`** | Persisted agent runs (AG-UI SSE) |
+
+---
+
+## CLI
+
+After install, the `synapsai` command is available:
+
+```bash
+# Upload a model directory into an existing artifact
+synapsai upload-model ./my-model --artifact-id artifact-demo-abc12345
+
+# Upload files or directories into a vector store
+synapsai upload-vector-store-files vs_abc123 ./docs ./readme.md
+```
+
+Environment variables:
+
+* `SYNAPSAI_API_KEY` — API key
+* `SYNAPSAI_API_BASE` — API base URL (default `https://api.synapsai.cloud/v1`)
 
 ---
 

{synapsai_python-0.1.0 → synapsai_python-0.1.2}/pyproject.toml

@@ -7,7 +7,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "synapsai-python"
-version = "0.1.0"
+version = "0.1.2"
 description = "The official SynapsAI Cloud Python SDK"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.8"
@@ -23,9 +23,13 @@ dependencies = [
     "httpx>=0.23.0",
     "pydantic>=2.0,<3",
     "typing-extensions>=4.5",
-    "Pillow>=9.5.0",
+    "Pillow>=12.2.0",
+    "click>=8.0",
 ]
 
+[project.scripts]
+synapsai = "synapsai.cli:main"
+
 [project.urls]
 Homepage = "https://github.com/synapsai-cloud/synapsai-python"
 

{synapsai_python-0.1.0 → synapsai_python-0.1.2}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="synapsai-python",
-    version="0.1.0",
+    version="0.1.2",
     description="The official SynapsAI Cloud Python SDK",
     long_description=open("README.md", "r", encoding="utf-8").read(),
     long_description_content_type="text/markdown",
@@ -22,6 +22,12 @@ setup(
         "httpx>=0.23.0",
         "pydantic>=2.0,<3",
         "typing-extensions>=4.5",
-        "Pillow>=9.5.0",
+        "Pillow>=12.2.0",
+        "click>=8.0",
     ],
+    entry_points={
+        "console_scripts": [
+            "synapsai=synapsai.cli:main",
+        ],
+    },
 )

{synapsai_python-0.1.0 → synapsai_python-0.1.2}/src/synapsai/__init__.py

@@ -5,12 +5,13 @@ A scalable and maintainable Python client library for interacting with SynapsAI
 compatible with OpenAI API patterns.
 """
 
-from .client import SynapsAI, AsyncSynapsAI
+from .client import SynapsAI, AsyncSynapsAI, DEFAULT_UPLOAD_BASE_URL
 from .types import *
 from .resources import *
 
-__version__ = "0.1.0"
+__version__ = "0.1.2"
 __all__ = [
     "SynapsAI",
     "AsyncSynapsAI",
+    "DEFAULT_UPLOAD_BASE_URL",
 ]

synapsai_python-0.1.2/src/synapsai/cli.py

@@ -0,0 +1,168 @@
+# Copyright 2026 SynapsAI Technologies Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+"""Command-line interface for SynapsAI uploads."""
+
+from __future__ import annotations
+
+import json
+import os
+from typing import List, Optional
+
+import click
+
+from .client import SynapsAI
+from .exceptions import APIError
+
+
+def _resolve_api_key(api_key: Optional[str]) -> str:
+    value = api_key or os.environ.get("SYNAPSAI_API_KEY")
+    if not value:
+        raise click.ClickException(
+            "API key required. Pass --api-key or set SYNAPSAI_API_KEY."
+        )
+    return value
+
+
+def _normalize_base_url(host: str) -> str:
+    value = host.strip().rstrip("/")
+    if not value.startswith("http://") and not value.startswith("https://"):
+        value = f"https://{value}"
+    if not value.endswith("/v1"):
+        value = f"{value}/v1"
+    return value
+
+
+@click.group()
+@click.version_option(version="0.1.0", prog_name="synapsai")
+def main() -> None:
+    """SynapsAI Cloud CLI."""
+
+
+@main.command("upload-model")
+@click.argument("path", type=click.Path(exists=True, file_okay=True, dir_okay=True))
+@click.option("--artifact-id", required=True, help="Existing model artifact id to upload into.")
+@click.option(
+    "--host",
+    default=None,
+    help="API host (default: SYNAPSAI_API_BASE or https://api.synapsai.cloud/v1).",
+)
+@click.option("--api-key", default=None, help="API key (default: SYNAPSAI_API_KEY).")
+@click.option("--timeout", default=3600.0, show_default=True, type=float, help="Request timeout seconds.")
+def upload_model(
+    path: str,
+    artifact_id: str,
+    host: Optional[str],
+    api_key: Optional[str],
+    timeout: float,
+) -> None:
+    """Upload model files into an existing artifact on the API.
+
+    PATH may be a single file or a directory of model weights/config files.
+    Starts an upload session, streams files, then completes ingest.
+    Uses the same host as the rest of the API (``SYNAPSAI_API_BASE`` or
+    ``https://api.synapsai.cloud/v1``).
+    """
+    base_url = _normalize_base_url(host) if host else None
+    client = SynapsAI(api_key=_resolve_api_key(api_key), base_url=base_url, timeout=timeout)
+
+    def on_progress(relative: str, index: int, total: int) -> None:
+        click.echo(f"[{index}/{total}] uploading {relative}")
+
+    try:
+        artifact = client.model_artifacts.upload(
+            path,
+            artifact_id=artifact_id,
+            on_progress=on_progress,
+        )
+    except (APIError, OSError, ValueError) as exc:
+        raise click.ClickException(str(exc)) from exc
+
+    click.echo(
+        json.dumps(
+            {
+                "id": artifact.id,
+                "display_name": artifact.display_name,
+                "pipeline": artifact.pipeline,
+                "status": artifact.status,
+                "size_gb": artifact.size_gb,
+            },
+            indent=2,
+        )
+    )
+
+
+@main.command("upload-vector-store-files")
+@click.argument("vector_store_id")
+@click.argument("paths", nargs=-1, required=True, type=click.Path(exists=True))
+@click.option(
+    "--host",
+    default=None,
+    help="API host (default: SYNAPSAI_API_BASE or https://api.synapsai.cloud/v1).",
+)
+@click.option("--api-key", default=None, help="API key (default: SYNAPSAI_API_KEY).")
+@click.option(
+    "--attributes",
+    default=None,
+    help="Optional JSON object applied as metadata attributes on each upload.",
+)
+@click.option("--timeout", default=600.0, show_default=True, type=float, help="Request timeout seconds.")
+def upload_vector_store_files(
+    vector_store_id: str,
+    paths: List[str],
+    host: Optional[str],
+    api_key: Optional[str],
+    attributes: Optional[str],
+    timeout: float,
+) -> None:
+    """Upload files or directories into a vector store.
+
+    Each PATH may be an individual file or a directory (recursively uploaded).
+    """
+    parsed_attributes = None
+    if attributes:
+        try:
+            parsed_attributes = json.loads(attributes)
+        except json.JSONDecodeError as exc:
+            raise click.ClickException("--attributes must be valid JSON") from exc
+        if not isinstance(parsed_attributes, dict):
+            raise click.ClickException("--attributes must be a JSON object")
+
+    base_url = None
+    if host:
+        base_url = _normalize_base_url(host)
+
+    client = SynapsAI(
+        api_key=_resolve_api_key(api_key),
+        base_url=base_url,
+        timeout=timeout,
+    )
+
+    try:
+        results = client.vector_stores.files.upload_paths(
+            vector_store_id,
+            list(paths),
+            attributes=parsed_attributes,
+        )
+    except (APIError, OSError, ValueError) as exc:
+        raise click.ClickException(str(exc)) from exc
+
+    for item in results:
+        click.echo(f"{item.id}\t{item.status}\t{item.usage_bytes}")
+
+    click.echo(f"Uploaded {len(results)} file(s) to vector store {vector_store_id}")
+
+
+if __name__ == "__main__":
+    main()