visionai-sdk-python 0.1.0__tar.gz → 1.0.0__tar.gz

visionai_sdk_python-1.0.0/.github/workflows/publish.yml

@@ -0,0 +1,54 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version-file: "pyproject.toml"
+
+      - name: Build package
+        run: uv build
+
+      - name: Upload distribution artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+  publish:
+    name: Publish to PyPI
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/visionai-sdk-python/
+    steps:
+      - name: Download distribution artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_TOKEN }}

visionai_sdk_python-1.0.0/.gitignore

@@ -0,0 +1,69 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Virtual environments
+venv/
+env/
+ENV/
+env.bak/
+venv.bak/
+.venv/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.tox/
+.nox/
+
+# Type checking
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pytype/
+
+# Jupyter
+.ipynb_checkpoints
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# Project specific
+*.log
+.python-version
+
+
+# Claude
+.claude/

visionai_sdk_python-1.0.0/PKG-INFO

@@ -0,0 +1,274 @@
+Metadata-Version: 2.4
+Name: visionai-sdk-python
+Version: 1.0.0
+Summary: VisionAI SDK for Python
+Author-email: Tony Yang <tonyyang@linkervision.com>
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: cryptography>=46.0.5
+Requires-Dist: PyJWT[cryptography]>=2.8.0
+
+# VisionAI SDK for Python
+
+Python client library for VisionAI authentication and Vision Language Model (VLM) inference services.
+
+## Features
+
+- **Dual Authentication**: Email/password login or OAuth client credentials
+- **Auto Token Management**: Automatic token refresh before expiration
+- **JWT Validation**: Built-in token signature and expiration verification
+- **VLM Inference**: Submit and poll vision-language model tasks
+- **Async Support**: Full async/await support with `AsyncClient`
+- **Type Safe**: Full type hints with Pydantic validation
+
+## Installation
+
+```bash
+pip install visionai-sdk-python
+```
+
+## Quick Start
+
+### Synchronous Usage
+
+```python
+from visionai_sdk_python import Client
+
+# Initialize client
+client = Client(
+    auth_url="https://auth.visionai.example.com",
+    vlm_url="https://vlm.visionai.example.com"
+)
+
+# Login with email/password
+token = client.login("user@example.com", "your-password")
+
+# Submit VLM inference request
+response = client.chat({
+    "img": "examplebase64",
+    "prompt": "Describe this image",
+    "temperature": 0.7,
+    "max_tokens": 500
+})
+
+print(f"Chat ID: {response.chat_id}")
+print(f"Status: {response.status}")
+
+# Poll for results
+result = client.get_chat(response.chat_id)
+if result.status == "completed":
+    print(f"Result: {result.message}")
+
+# Close client when done
+client.close()
+```
+
+### Asynchronous Usage
+
+```python
+import asyncio
+from visionai_sdk_python import AsyncClient
+
+async def main():
+    async with AsyncClient(
+        auth_url="https://auth.visionai.example.com",
+        vlm_url="https://vlm.visionai.example.com"
+    ) as client:
+        # OAuth client credentials flow
+        await client.get_access_token(
+            client_id="your-client-id",
+            client_secret="your-client-secret"
+        )
+
+        # Submit inference
+        response = await client.chat({
+            "img": "examplebase64",
+            "prompt": "What objects are in this image?",
+            "temperature": 0.2
+        })
+
+        # Poll until completed
+        while True:
+            result = await client.get_chat(response.chat_id)
+            if result.status in ("completed", "failed", "timeout"):
+                break
+            await asyncio.sleep(1)
+
+        if result.status == "completed":
+            print(f"Answer: {result.message}")
+        else:
+            print(f"Error: {result.error}")
+
+asyncio.run(main())
+```
+
+## Authentication
+
+### Email/Password Login
+
+```python
+client = Client(auth_url="...", vlm_url="...")
+token = client.login("user@example.com", "password")
+```
+
+### OAuth Client Credentials
+
+```python
+client = Client(auth_url="...", vlm_url="...")
+token = client.get_access_token(
+    client_id="your-client-id",
+    client_secret="your-client-secret"
+)
+```
+
+Tokens are stored internally and automatically refreshed before expiration.
+
+## VLM Inference
+
+### Submit Chat Request
+
+```python
+from visionai_sdk_python.models import NIMRequestModel
+
+# Using dict
+response = client.chat({
+    "img": "examplebase64",
+    "prompt": "Analyze this image",
+    "temperature": 0.7,
+    "max_tokens": 1000,
+    "top_p": 0.9
+})
+
+# Using typed model
+request = NIMRequestModel(
+    img=["examplebase64"],
+    prompt="Compare these images",
+    temperature=0.5,
+    max_tokens=500
+)
+response = client.chat(request)
+```
+
+### Check Result
+
+```python
+result = client.get_chat(response.chat_id)
+
+if result.status == "completed":
+    print(result.message)
+elif result.status in ("failed", "timeout"):
+    print(f"Error: {result.error}")
+```
+
+**Response Status:**
+- `pending`: Request queued
+- `running`: Processing
+- `completed`: Success, check `message`
+- `failed`: Error, check `error`
+- `timeout`: Request timeout
+
+## Token Validation
+
+```python
+# Validate any JWT token
+is_valid = client.is_token_valid("eyJhbGci...")
+if is_valid:
+    print("Token is valid")
+else:
+    print("Token is expired or invalid")
+```
+
+## Configuration
+
+```python
+client = Client(
+    auth_url="https://auth.example.com",
+    vlm_url="https://vlm.example.com",
+    allowed_issuers=["https://auth.example.com"],  # Optional: restrict token issuers
+    verify_ssl=True,                                # SSL verification
+    timeout=10.0,                                   # Request timeout in seconds
+    max_connections=100,                            # Connection pool size
+    max_keepalive_connections=20                    # Keepalive connections
+)
+```
+
+## Error Handling
+
+```python
+from visionai_sdk_python import (
+    VisionaiSDKError,
+    AuthenticationError,
+    NetworkError,
+    ClientError,
+    ServerError
+)
+
+try:
+    client.login("user@example.com", "wrong-password")
+except AuthenticationError as e:
+    print(f"Auth failed: {e}")
+except NetworkError as e:
+    print(f"Network error: {e}")
+except VisionaiSDKError as e:
+    print(f"SDK error: {e}")
+```
+
+**Exception Hierarchy:**
+- `VisionaiSDKError`: Base exception
+  - `AuthenticationError`: 401 Unauthorized
+  - `PermissionDeniedError`: 403 Forbidden
+  - `ClientError`: 4xx client errors
+  - `ServerError`: 5xx server errors
+  - `NetworkError`: Connection/timeout errors
+  - `JwksDiscoveryError`: OIDC discovery failures
+
+## Context Manager Usage
+
+Recommended for automatic resource cleanup:
+
+```python
+# Sync
+with Client(auth_url="...", vlm_url="...") as client:
+    client.login("user@example.com", "password")
+    response = client.chat({"img": "...", "prompt": "..."})
+# client.close() called automatically
+
+# Async
+async with AsyncClient(auth_url="...", vlm_url="...") as client:
+    await client.login("user@example.com", "password")
+    response = await client.chat({"img": "...", "prompt": "..."})
+# client.close() called automatically
+```
+
+## Development
+
+### Install Dependencies
+
+```bash
+# Using uv (recommended)
+uv sync
+
+# Or with pip
+pip install -e ".[dev]"
+```
+
+### Run Tests
+
+```bash
+pytest
+```
+
+## Requirements
+
+- Python >= 3.11
+- httpx >= 0.28.1
+- pydantic >= 2.12.5
+- cryptography >= 46.0.5
+- PyJWT[cryptography] >= 2.8.0
+
+
+## Support
+
+For issues and questions, please open an issue on GitHub.

visionai_sdk_python-1.0.0/README.md

@@ -0,0 +1,262 @@
+# VisionAI SDK for Python
+
+Python client library for VisionAI authentication and Vision Language Model (VLM) inference services.
+
+## Features
+
+- **Dual Authentication**: Email/password login or OAuth client credentials
+- **Auto Token Management**: Automatic token refresh before expiration
+- **JWT Validation**: Built-in token signature and expiration verification
+- **VLM Inference**: Submit and poll vision-language model tasks
+- **Async Support**: Full async/await support with `AsyncClient`
+- **Type Safe**: Full type hints with Pydantic validation
+
+## Installation
+
+```bash
+pip install visionai-sdk-python
+```
+
+## Quick Start
+
+### Synchronous Usage
+
+```python
+from visionai_sdk_python import Client
+
+# Initialize client
+client = Client(
+    auth_url="https://auth.visionai.example.com",
+    vlm_url="https://vlm.visionai.example.com"
+)
+
+# Login with email/password
+token = client.login("user@example.com", "your-password")
+
+# Submit VLM inference request
+response = client.chat({
+    "img": "examplebase64",
+    "prompt": "Describe this image",
+    "temperature": 0.7,
+    "max_tokens": 500
+})
+
+print(f"Chat ID: {response.chat_id}")
+print(f"Status: {response.status}")
+
+# Poll for results
+result = client.get_chat(response.chat_id)
+if result.status == "completed":
+    print(f"Result: {result.message}")
+
+# Close client when done
+client.close()
+```
+
+### Asynchronous Usage
+
+```python
+import asyncio
+from visionai_sdk_python import AsyncClient
+
+async def main():
+    async with AsyncClient(
+        auth_url="https://auth.visionai.example.com",
+        vlm_url="https://vlm.visionai.example.com"
+    ) as client:
+        # OAuth client credentials flow
+        await client.get_access_token(
+            client_id="your-client-id",
+            client_secret="your-client-secret"
+        )
+
+        # Submit inference
+        response = await client.chat({
+            "img": "examplebase64",
+            "prompt": "What objects are in this image?",
+            "temperature": 0.2
+        })
+
+        # Poll until completed
+        while True:
+            result = await client.get_chat(response.chat_id)
+            if result.status in ("completed", "failed", "timeout"):
+                break
+            await asyncio.sleep(1)
+
+        if result.status == "completed":
+            print(f"Answer: {result.message}")
+        else:
+            print(f"Error: {result.error}")
+
+asyncio.run(main())
+```
+
+## Authentication
+
+### Email/Password Login
+
+```python
+client = Client(auth_url="...", vlm_url="...")
+token = client.login("user@example.com", "password")
+```
+
+### OAuth Client Credentials
+
+```python
+client = Client(auth_url="...", vlm_url="...")
+token = client.get_access_token(
+    client_id="your-client-id",
+    client_secret="your-client-secret"
+)
+```
+
+Tokens are stored internally and automatically refreshed before expiration.
+
+## VLM Inference
+
+### Submit Chat Request
+
+```python
+from visionai_sdk_python.models import NIMRequestModel
+
+# Using dict
+response = client.chat({
+    "img": "examplebase64",
+    "prompt": "Analyze this image",
+    "temperature": 0.7,
+    "max_tokens": 1000,
+    "top_p": 0.9
+})
+
+# Using typed model
+request = NIMRequestModel(
+    img=["examplebase64"],
+    prompt="Compare these images",
+    temperature=0.5,
+    max_tokens=500
+)
+response = client.chat(request)
+```
+
+### Check Result
+
+```python
+result = client.get_chat(response.chat_id)
+
+if result.status == "completed":
+    print(result.message)
+elif result.status in ("failed", "timeout"):
+    print(f"Error: {result.error}")
+```
+
+**Response Status:**
+- `pending`: Request queued
+- `running`: Processing
+- `completed`: Success, check `message`
+- `failed`: Error, check `error`
+- `timeout`: Request timeout
+
+## Token Validation
+
+```python
+# Validate any JWT token
+is_valid = client.is_token_valid("eyJhbGci...")
+if is_valid:
+    print("Token is valid")
+else:
+    print("Token is expired or invalid")
+```
+
+## Configuration
+
+```python
+client = Client(
+    auth_url="https://auth.example.com",
+    vlm_url="https://vlm.example.com",
+    allowed_issuers=["https://auth.example.com"],  # Optional: restrict token issuers
+    verify_ssl=True,                                # SSL verification
+    timeout=10.0,                                   # Request timeout in seconds
+    max_connections=100,                            # Connection pool size
+    max_keepalive_connections=20                    # Keepalive connections
+)
+```
+
+## Error Handling
+
+```python
+from visionai_sdk_python import (
+    VisionaiSDKError,
+    AuthenticationError,
+    NetworkError,
+    ClientError,
+    ServerError
+)
+
+try:
+    client.login("user@example.com", "wrong-password")
+except AuthenticationError as e:
+    print(f"Auth failed: {e}")
+except NetworkError as e:
+    print(f"Network error: {e}")
+except VisionaiSDKError as e:
+    print(f"SDK error: {e}")
+```
+
+**Exception Hierarchy:**
+- `VisionaiSDKError`: Base exception
+  - `AuthenticationError`: 401 Unauthorized
+  - `PermissionDeniedError`: 403 Forbidden
+  - `ClientError`: 4xx client errors
+  - `ServerError`: 5xx server errors
+  - `NetworkError`: Connection/timeout errors
+  - `JwksDiscoveryError`: OIDC discovery failures
+
+## Context Manager Usage
+
+Recommended for automatic resource cleanup:
+
+```python
+# Sync
+with Client(auth_url="...", vlm_url="...") as client:
+    client.login("user@example.com", "password")
+    response = client.chat({"img": "...", "prompt": "..."})
+# client.close() called automatically
+
+# Async
+async with AsyncClient(auth_url="...", vlm_url="...") as client:
+    await client.login("user@example.com", "password")
+    response = await client.chat({"img": "...", "prompt": "..."})
+# client.close() called automatically
+```
+
+## Development
+
+### Install Dependencies
+
+```bash
+# Using uv (recommended)
+uv sync
+
+# Or with pip
+pip install -e ".[dev]"
+```
+
+### Run Tests
+
+```bash
+pytest
+```
+
+## Requirements
+
+- Python >= 3.11
+- httpx >= 0.28.1
+- pydantic >= 2.12.5
+- cryptography >= 46.0.5
+- PyJWT[cryptography] >= 2.8.0
+
+
+## Support
+
+For issues and questions, please open an issue on GitHub.

{visionai_sdk_python-0.1.0 → visionai_sdk_python-1.0.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "visionai-sdk-python"
-version = "0.1.0"
+dynamic = ["version"]
 description = "VisionAI SDK for Python"
 readme = "README.md"
 authors = [
@@ -15,8 +15,10 @@ dependencies = [
 ]
 
 [build-system]
-requires = ["uv_build>=0.9.18,<0.10.0"]
-build-backend = "uv_build"
+requires = ["setuptools>=64", "setuptools-scm>=8"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools_scm]
 
 [dependency-groups]
 dev = [

visionai_sdk_python-1.0.0/setup.cfg

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