lawsaathi 1.0.0__tar.gz

lawsaathi-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 LawSaathi
+
+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.

lawsaathi-1.0.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include LICENSE
+include README.md
+include pyproject.toml
+recursive-include lawsaathi *.py

lawsaathi-1.0.0/PKG-INFO

@@ -0,0 +1,174 @@
+Metadata-Version: 2.4
+Name: lawsaathi
+Version: 1.0.0
+Summary: Official Python SDK for LawSaathi Legal AI API — DELTA
+Home-page: https://github.com/lawsaathi/lawsaathi-python-sdk
+Author: LawSaathi
+Author-email: LawSaathi <support@lawsaathi.com>
+License: MIT
+Project-URL: Homepage, https://lawsaathi.com
+Project-URL: Documentation, https://lawsaathi.com/docs
+Project-URL: Repository, https://github.com/lawsaathi/lawsaathi-python-sdk
+Project-URL: Dashboard, https://lawsaathi.com/developer
+Project-URL: Bug Tracker, https://github.com/lawsaathi/lawsaathi-python-sdk/issues
+Keywords: lawsaathi,legal-ai,indian-law,ipc,crpc,delta,ai-sdk,legal-tech,chatbot,api-client
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+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
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Provides-Extra: websocket
+Requires-Dist: websocket-client>=1.0.0; extra == "websocket"
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0; extra == "dev"
+Requires-Dist: pytest-cov>=2.0; extra == "dev"
+Requires-Dist: black>=21.0; extra == "dev"
+Requires-Dist: flake8>=3.9; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# LawSaathi Python SDK
+
+[![PyPI version](https://img.shields.io/pypi/v/lawsaathi.svg)](https://pypi.org/project/lawsaathi/)
+[![Python versions](https://img.shields.io/pypi/pyversions/lawsaathi.svg)](https://pypi.org/project/lawsaathi/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Official Python client for the **LawSaathi Legal AI API** — powered by **DELTA**, India's most advanced Legal AI.
+
+## Installation
+
+```bash
+pip install lawsaathi
+
+# With WebSocket streaming support:
+pip install lawsaathi[websocket]
+```
+
+## Quick Start
+
+```python
+from lawsaathi import LawSaathi
+
+client = LawSaathi(api_key="ls_live_your_api_key_here")
+
+# Ask any legal question
+response = client.chat("What is IPC Section 302?")
+print(response['response'])
+print(f"Tokens used: {response['usage']['total_tokens']}")
+print(f"Cost: ₹{response['usage']['cost_rupees']}")
+```
+
+## File Attachments (OpenAI-style)
+
+Attach files to your queries — just pass file paths. The SDK handles uploading automatically.
+
+```python
+# Analyze a contract — just pass the file path!
+response = client.chat(
+    "Summarize the key clauses in this contract",
+    files=["contract.pdf"]
+)
+print(response['response'])
+
+# Multiple files work too
+response = client.chat(
+    "Compare these two agreements",
+    files=["agreement_v1.pdf", "agreement_v2.pdf"]
+)
+```
+
+## Streaming (WebSocket)
+
+```python
+# Requires: pip install lawsaathi[websocket]
+for chunk in client.stream("Explain bail provisions under CrPC"):
+    print(chunk, end="", flush=True)
+
+# Streaming with files
+for chunk in client.stream("Analyze this document", files=["contract.pdf"]):
+    print(chunk, end="", flush=True)
+```
+
+## Check Balance
+
+```python
+balance = client.get_balance()
+print(f"Balance: ₹{balance['balance_rupees']}")
+print(f"Tokens available: {balance['tokens_available']:,}")
+```
+
+## Error Handling
+
+```python
+from lawsaathi import (
+    LawSaathi,
+    AuthenticationError,
+    RateLimitError,
+    InsufficientCreditsError,
+    APIError,
+)
+
+client = LawSaathi(api_key="ls_live_your_key")
+
+try:
+    response = client.chat("Hello")
+except AuthenticationError:
+    print("Invalid API key — check or regenerate it")
+except InsufficientCreditsError as e:
+    print(f"Not enough credits. Balance: ₹{e.balance_rupees}")
+except RateLimitError as e:
+    print(f"Rate limited. Retry after: {e.retry_after}s")
+except APIError as e:
+    print(f"API error ({e.status_code}): {e}")
+```
+
+## Pricing
+
+| | |
+|---|---|
+| **Cost per 1M tokens** | ₹998 |
+| **Free credits on signup** | ₹100 |
+| **Minimum topup** | ₹999 |
+| **Credit expiry** | 150 days |
+
+## Rate Limits
+
+| Limit | Default |
+|-------|---------|
+| Requests/minute | 5 |
+| Requests/day | 2,500 |
+| Max file size | 100 MB |
+
+Need higher limits? Contact support@lawsaathi.com.
+
+## Requirements
+
+- Python 3.8+
+- `requests` library (installed automatically)
+- `websocket-client` (optional, for streaming)
+
+## Links
+
+- **Dashboard**: [lawsaathi.com/developer](https://lawsaathi.com/developer)
+- **API Docs**: [lawsaathi.com/docs](https://lawsaathi.com/docs)
+- **Support**: support@lawsaathi.com
+
+## License
+
+MIT License — see [LICENSE](LICENSE) for details.

lawsaathi-1.0.0/README.md

@@ -0,0 +1,129 @@
+# LawSaathi Python SDK
+
+[![PyPI version](https://img.shields.io/pypi/v/lawsaathi.svg)](https://pypi.org/project/lawsaathi/)
+[![Python versions](https://img.shields.io/pypi/pyversions/lawsaathi.svg)](https://pypi.org/project/lawsaathi/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Official Python client for the **LawSaathi Legal AI API** — powered by **DELTA**, India's most advanced Legal AI.
+
+## Installation
+
+```bash
+pip install lawsaathi
+
+# With WebSocket streaming support:
+pip install lawsaathi[websocket]
+```
+
+## Quick Start
+
+```python
+from lawsaathi import LawSaathi
+
+client = LawSaathi(api_key="ls_live_your_api_key_here")
+
+# Ask any legal question
+response = client.chat("What is IPC Section 302?")
+print(response['response'])
+print(f"Tokens used: {response['usage']['total_tokens']}")
+print(f"Cost: ₹{response['usage']['cost_rupees']}")
+```
+
+## File Attachments (OpenAI-style)
+
+Attach files to your queries — just pass file paths. The SDK handles uploading automatically.
+
+```python
+# Analyze a contract — just pass the file path!
+response = client.chat(
+    "Summarize the key clauses in this contract",
+    files=["contract.pdf"]
+)
+print(response['response'])
+
+# Multiple files work too
+response = client.chat(
+    "Compare these two agreements",
+    files=["agreement_v1.pdf", "agreement_v2.pdf"]
+)
+```
+
+## Streaming (WebSocket)
+
+```python
+# Requires: pip install lawsaathi[websocket]
+for chunk in client.stream("Explain bail provisions under CrPC"):
+    print(chunk, end="", flush=True)
+
+# Streaming with files
+for chunk in client.stream("Analyze this document", files=["contract.pdf"]):
+    print(chunk, end="", flush=True)
+```
+
+## Check Balance
+
+```python
+balance = client.get_balance()
+print(f"Balance: ₹{balance['balance_rupees']}")
+print(f"Tokens available: {balance['tokens_available']:,}")
+```
+
+## Error Handling
+
+```python
+from lawsaathi import (
+    LawSaathi,
+    AuthenticationError,
+    RateLimitError,
+    InsufficientCreditsError,
+    APIError,
+)
+
+client = LawSaathi(api_key="ls_live_your_key")
+
+try:
+    response = client.chat("Hello")
+except AuthenticationError:
+    print("Invalid API key — check or regenerate it")
+except InsufficientCreditsError as e:
+    print(f"Not enough credits. Balance: ₹{e.balance_rupees}")
+except RateLimitError as e:
+    print(f"Rate limited. Retry after: {e.retry_after}s")
+except APIError as e:
+    print(f"API error ({e.status_code}): {e}")
+```
+
+## Pricing
+
+| | |
+|---|---|
+| **Cost per 1M tokens** | ₹998 |
+| **Free credits on signup** | ₹100 |
+| **Minimum topup** | ₹999 |
+| **Credit expiry** | 150 days |
+
+## Rate Limits
+
+| Limit | Default |
+|-------|---------|
+| Requests/minute | 5 |
+| Requests/day | 2,500 |
+| Max file size | 100 MB |
+
+Need higher limits? Contact support@lawsaathi.com.
+
+## Requirements
+
+- Python 3.8+
+- `requests` library (installed automatically)
+- `websocket-client` (optional, for streaming)
+
+## Links
+
+- **Dashboard**: [lawsaathi.com/developer](https://lawsaathi.com/developer)
+- **API Docs**: [lawsaathi.com/docs](https://lawsaathi.com/docs)
+- **Support**: support@lawsaathi.com
+
+## License
+
+MIT License — see [LICENSE](LICENSE) for details.

lawsaathi-1.0.0/lawsaathi/__init__.py

@@ -0,0 +1,40 @@
+# LawSaathi Python SDK
+"""
+Official Python SDK for LawSaathi Legal AI API.
+
+Quick Start:
+    from lawsaathi import LawSaathi
+
+    client = LawSaathi(api_key="ls_live_xxxxx")
+    
+    # Non-streaming (HTTP)
+    response = client.chat("What is IPC Section 302?")
+    print(response['response'])
+    
+    # Streaming (WebSocket)
+    for chunk in client.stream("Explain bail under CrPC"):
+        print(chunk, end="", flush=True)
+    
+    # Check balance
+    balance = client.get_balance()
+    print(f"₹{balance['balance_rupees']}")
+"""
+
+from .client import LawSaathi
+from .exceptions import (
+    LawSaathiError,
+    AuthenticationError,
+    RateLimitError,
+    InsufficientCreditsError,
+    APIError,
+)
+
+__version__ = "1.0.0"
+__all__ = [
+    "LawSaathi",
+    "LawSaathiError",
+    "AuthenticationError",
+    "RateLimitError",
+    "InsufficientCreditsError",
+    "APIError",
+]

lawsaathi-1.0.0/lawsaathi/client.py

@@ -0,0 +1,390 @@
+"""
+LawSaathi Python SDK — Main Client
+====================================
+Supports both non-streaming (HTTP) and streaming (WebSocket) modes.
+
+Usage:
+    from lawsaathi import LawSaathi
+
+    client = LawSaathi(api_key="ls_live_xxxxx")
+
+    # Non-streaming (HTTP POST)
+    response = client.chat("What is IPC Section 302?")
+    print(response['response'])
+
+    # Chat with file attachments (just pass file paths — like OpenAI)
+    response = client.chat(
+        "Summarize this contract",
+        files=["contract.pdf", "annexure.pdf"]
+    )
+    print(response['response'])
+
+    # Streaming (WebSocket)
+    for chunk in client.stream("Explain bail under CrPC"):
+        print(chunk, end="", flush=True)
+
+    # Check balance
+    print(client.get_balance())
+"""
+
+import json
+import time
+import threading
+import logging
+from typing import Optional, List, Dict, Any, Generator
+from urllib.parse import urljoin
+
+import requests
+
+try:
+    import websocket as ws_lib  # websocket-client
+    HAS_WEBSOCKET = True
+except ImportError:
+    HAS_WEBSOCKET = False
+
+from .exceptions import (
+    LawSaathiError,
+    AuthenticationError,
+    RateLimitError,
+    InsufficientCreditsError,
+    APIError,
+)
+
+__version__ = "1.0.0"
+logger = logging.getLogger("lawsaathi")
+
+
+class LawSaathi:
+    """
+    Official LawSaathi Python SDK client.
+
+    Args:
+        api_key: Your API key (starts with 'ls_live_').
+        base_url: Base HTTP URL (default: https://api.lawsaathi.com).
+        ws_url: Base WebSocket URL (default: wss://api.lawsaathi.com).
+        timeout: HTTP request timeout in seconds (default: 120).
+        max_retries: Max retries on transient failures (default: 2).
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+        base_url: str = "https://api.lawsaathi.com",
+        ws_url: str = "wss://api.lawsaathi.com",
+        timeout: int = 120,
+        max_retries: int = 2,
+    ):
+        if not api_key or not api_key.startswith("ls_live_"):
+            raise ValueError("Invalid API key. Must start with 'ls_live_'.")
+
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self.ws_url = ws_url.rstrip("/")
+        self.timeout = timeout
+        self.max_retries = max_retries
+
+        self._session = requests.Session()
+        self._session.headers.update({
+            "X-API-Key": api_key,
+            "Content-Type": "application/json",
+            "User-Agent": f"LawSaathi-Python-SDK/{__version__}",
+        })
+
+    # =========================================================================
+    # Non-Streaming Chat (HTTP POST)
+    # =========================================================================
+
+    def chat(
+        self,
+        message: str,
+        files: Optional[List[str]] = None,
+        file_uris: Optional[List[str]] = None,
+        session_id: Optional[str] = None,
+    ) -> Dict[str, Any]:
+        """
+        Send a message to DELTA and get a complete response (non-streaming).
+
+        Args:
+            message: Your question or prompt.
+            files: Optional list of file paths to attach (PDF, DOCX, TXT, JPG, PNG).
+                   Files are uploaded automatically — you never need to manage URIs.
+            file_uris: Optional list of pre-uploaded GCS URIs (advanced use only).
+            session_id: Optional session ID for conversation continuity.
+
+        Returns:
+            Dict with 'response', 'usage', 'response_time_ms', 'balance_remaining_rupees'.
+
+        Example:
+            # Simple query
+            response = client.chat("What is IPC Section 302?")
+
+            # With file attachments (just pass paths!)
+            response = client.chat(
+                "Summarize this contract",
+                files=["contract.pdf"]
+            )
+        """
+        # Auto-upload files if provided
+        all_uris = list(file_uris or [])
+        if files:
+            for file_path in files:
+                upload_result = self.upload_file(file_path)
+                all_uris.append(upload_result['file_ref'])
+
+        payload = {"message": message}
+        if all_uris:
+            payload["file_uris"] = all_uris
+        if session_id:
+            payload["session_id"] = session_id
+
+        return self._request("POST", "/api/sdk/chat/", json=payload)
+
+    # =========================================================================
+    # Streaming Chat (WebSocket)
+    # =========================================================================
+
+    def stream(
+        self,
+        message: str,
+        files: Optional[List[str]] = None,
+        file_uris: Optional[List[str]] = None,
+        session_id: Optional[str] = None,
+    ) -> Generator[str, None, Dict[str, Any]]:
+        """
+        Stream a DELTA response via WebSocket. Yields text chunks.
+
+        Args:
+            message: Your question or prompt.
+            files: Optional list of file paths to attach (auto-uploaded).
+            file_uris: Optional list of pre-uploaded GCS URIs (advanced).
+            session_id: Optional session ID.
+
+        Yields:
+            Text chunks as they arrive.
+
+        Example:
+            for chunk in client.stream("Explain Article 21"):
+                print(chunk, end="", flush=True)
+
+            # With files
+            for chunk in client.stream("Summarize this", files=["doc.pdf"]):
+                print(chunk, end="", flush=True)
+        """
+        if not HAS_WEBSOCKET:
+            raise LawSaathiError(
+                "WebSocket streaming requires 'websocket-client'. "
+                "Install it: pip install websocket-client"
+            )
+
+        # Auto-upload files if provided
+        all_uris = list(file_uris or [])
+        if files:
+            for file_path in files:
+                upload_result = self.upload_file(file_path)
+                all_uris.append(upload_result['file_ref'])
+        file_uris = all_uris or None
+
+        ws_endpoint = f"{self.ws_url}/ws/sdk/delta/?api_key={self.api_key}"
+        chunks = []
+        usage_info = {}
+        error_msg = None
+        done_event = threading.Event()
+
+        def on_message(ws_conn, raw):
+            nonlocal usage_info, error_msg
+            try:
+                data = json.loads(raw)
+                msg_type = data.get("type", "")
+                if msg_type == "chunk":
+                    chunks.append(data.get("text", ""))
+                elif msg_type == "done":
+                    usage_info = data
+                    done_event.set()
+                    ws_conn.close()
+                elif msg_type == "error":
+                    error_msg = data.get("error", "Unknown error")
+                    done_event.set()
+                    ws_conn.close()
+                elif msg_type == "status":
+                    pass  # Processing status, ignore
+            except json.JSONDecodeError:
+                pass
+
+        def on_error(ws_conn, err):
+            nonlocal error_msg
+            error_msg = str(err)
+            done_event.set()
+
+        def on_open(ws_conn):
+            payload = {"message": message}
+            if file_uris:
+                payload["file_uris"] = file_uris
+            if session_id:
+                payload["session_id"] = session_id
+            ws_conn.send(json.dumps(payload))
+
+        def on_close(ws_conn, close_status_code, close_msg):
+            done_event.set()
+
+        ws_app = ws_lib.WebSocketApp(
+            ws_endpoint,
+            on_open=on_open,
+            on_message=on_message,
+            on_error=on_error,
+            on_close=on_close,
+        )
+
+        # Run WebSocket in a background thread
+        ws_thread = threading.Thread(target=ws_app.run_forever, daemon=True)
+        ws_thread.start()
+
+        # Yield chunks as they arrive
+        yielded = 0
+        while not done_event.is_set() or yielded < len(chunks):
+            if yielded < len(chunks):
+                yield chunks[yielded]
+                yielded += 1
+            else:
+                done_event.wait(timeout=0.05)
+
+        # Yield any remaining chunks
+        while yielded < len(chunks):
+            yield chunks[yielded]
+            yielded += 1
+
+        ws_thread.join(timeout=5)
+
+        if error_msg:
+            if "Insufficient credits" in error_msg:
+                raise InsufficientCreditsError(error_msg)
+            elif "Rate limit" in error_msg:
+                raise RateLimitError(error_msg)
+            else:
+                raise APIError(error_msg)
+
+        return usage_info
+
+    # =========================================================================
+    # File Upload (handled internally — users don't need to call this directly)
+    # =========================================================================
+
+    def upload_file(self, file_path: str) -> Dict[str, Any]:
+        """
+        Upload a file via HTTP. Returns a file reference for use in queries.
+
+        You usually don't need to call this directly — just pass `files=["path"]`
+        to `chat()` or `stream()` and it's handled automatically.
+
+        Args:
+            file_path: Path to file (PDF, DOCX, TXT, JPG, PNG).
+
+        Returns:
+            Dict with 'file_ref', 'file_id', 'filename', 'size'.
+        """
+        import os
+        if not os.path.exists(file_path):
+            raise FileNotFoundError(f"File not found: {file_path}")
+
+        filename = os.path.basename(file_path)
+        url = f"{self.base_url}/api/sdk/upload/"
+
+        # Use a fresh request (NOT the session, which has Content-Type: application/json)
+        with open(file_path, "rb") as f:
+            response = requests.post(
+                url,
+                files={"file": (filename, f)},
+                headers={
+                    "X-API-Key": self.api_key,
+                    "User-Agent": f"LawSaathi-Python-SDK/{__version__}",
+                },
+                timeout=self.timeout,
+            )
+
+        return self._handle_response(response)
+
+    # =========================================================================
+    # Balance & Health
+    # =========================================================================
+
+    def get_balance(self) -> Dict[str, Any]:
+        """
+        Check remaining wallet balance and token availability.
+
+        Returns:
+            Dict with 'balance_rupees', 'tokens_available', etc.
+        """
+        return self._request("GET", "/api/sdk/balance/")
+
+    def health(self) -> Dict[str, Any]:
+        """
+        Check API health and your auth status.
+
+        Returns:
+            Dict with 'status', 'version', 'authenticated', etc.
+        """
+        return self._request("GET", "/api/sdk/health/")
+
+    # =========================================================================
+    # Internal HTTP helpers
+    # =========================================================================
+
+    def _request(self, method: str, endpoint: str, **kwargs) -> Dict[str, Any]:
+        """Make an HTTP request with retry logic."""
+        url = f"{self.base_url}{endpoint}"
+        last_error = None
+
+        for attempt in range(self.max_retries + 1):
+            try:
+                response = self._session.request(
+                    method=method,
+                    url=url,
+                    timeout=self.timeout,
+                    **kwargs,
+                )
+                return self._handle_response(response)
+
+            except (requests.exceptions.Timeout, requests.exceptions.ConnectionError) as e:
+                last_error = e
+                if attempt < self.max_retries:
+                    wait = (attempt + 1) * 2
+                    logger.warning(f"Request failed (attempt {attempt + 1}), retrying in {wait}s: {e}")
+                    time.sleep(wait)
+                    continue
+                raise APIError(f"Request failed after {self.max_retries + 1} attempts: {e}")
+
+            except (AuthenticationError, RateLimitError, InsufficientCreditsError):
+                raise  # Don't retry auth/rate/credit errors
+
+            except requests.exceptions.RequestException as e:
+                raise APIError(f"Request failed: {e}")
+
+        raise APIError(f"Request failed: {last_error}")
+
+    def _handle_response(self, response: requests.Response) -> Dict[str, Any]:
+        """Handle HTTP response, raising appropriate exceptions."""
+        if response.status_code == 401:
+            raise AuthenticationError("Invalid or expired API key.")
+        if response.status_code == 402:
+            data = response.json() if response.content else {}
+            raise InsufficientCreditsError(
+                data.get("message", "Insufficient credits."),
+                balance_rupees=data.get("balance_rupees"),
+            )
+        if response.status_code == 429:
+            data = response.json() if response.content else {}
+            raise RateLimitError(
+                data.get("message", "Rate limit exceeded."),
+                retry_after=response.headers.get("Retry-After"),
+            )
+        if response.status_code >= 400:
+            try:
+                data = response.json()
+                msg = data.get("error", data.get("message", response.text))
+            except Exception:
+                msg = response.text
+            raise APIError(msg, status_code=response.status_code, response=response)
+
+        return response.json()
+
+    def __repr__(self):
+        return f"LawSaathi(api_key='{self.api_key[:12]}...', base_url='{self.base_url}')"

lawsaathi-1.0.0/lawsaathi/exceptions.py

@@ -0,0 +1,33 @@
+"""Custom exceptions for LawSaathi SDK."""
+
+
+class LawSaathiError(Exception):
+    """Base exception for all LawSaathi SDK errors."""
+    pass
+
+
+class AuthenticationError(LawSaathiError):
+    """Raised when API key authentication fails (401)."""
+    pass
+
+
+class RateLimitError(LawSaathiError):
+    """Raised when rate limit is exceeded (429)."""
+    def __init__(self, message, retry_after=None):
+        super().__init__(message)
+        self.retry_after = retry_after
+
+
+class InsufficientCreditsError(LawSaathiError):
+    """Raised when wallet balance is insufficient (402)."""
+    def __init__(self, message, balance_rupees=None):
+        super().__init__(message)
+        self.balance_rupees = balance_rupees
+
+
+class APIError(LawSaathiError):
+    """Raised for general API errors (4xx/5xx)."""
+    def __init__(self, message, status_code=None, response=None):
+        super().__init__(message)
+        self.status_code = status_code
+        self.response = response

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

@@ -0,0 +1,174 @@
+Metadata-Version: 2.4
+Name: lawsaathi
+Version: 1.0.0
+Summary: Official Python SDK for LawSaathi Legal AI API — DELTA
+Home-page: https://github.com/lawsaathi/lawsaathi-python-sdk
+Author: LawSaathi
+Author-email: LawSaathi <support@lawsaathi.com>
+License: MIT
+Project-URL: Homepage, https://lawsaathi.com
+Project-URL: Documentation, https://lawsaathi.com/docs
+Project-URL: Repository, https://github.com/lawsaathi/lawsaathi-python-sdk
+Project-URL: Dashboard, https://lawsaathi.com/developer
+Project-URL: Bug Tracker, https://github.com/lawsaathi/lawsaathi-python-sdk/issues
+Keywords: lawsaathi,legal-ai,indian-law,ipc,crpc,delta,ai-sdk,legal-tech,chatbot,api-client
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+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
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.0
+Provides-Extra: websocket
+Requires-Dist: websocket-client>=1.0.0; extra == "websocket"
+Provides-Extra: dev
+Requires-Dist: pytest>=6.0; extra == "dev"
+Requires-Dist: pytest-cov>=2.0; extra == "dev"
+Requires-Dist: black>=21.0; extra == "dev"
+Requires-Dist: flake8>=3.9; extra == "dev"
+Requires-Dist: build; extra == "dev"
+Requires-Dist: twine; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# LawSaathi Python SDK
+
+[![PyPI version](https://img.shields.io/pypi/v/lawsaathi.svg)](https://pypi.org/project/lawsaathi/)
+[![Python versions](https://img.shields.io/pypi/pyversions/lawsaathi.svg)](https://pypi.org/project/lawsaathi/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+Official Python client for the **LawSaathi Legal AI API** — powered by **DELTA**, India's most advanced Legal AI.
+
+## Installation
+
+```bash
+pip install lawsaathi
+
+# With WebSocket streaming support:
+pip install lawsaathi[websocket]
+```
+
+## Quick Start
+
+```python
+from lawsaathi import LawSaathi
+
+client = LawSaathi(api_key="ls_live_your_api_key_here")
+
+# Ask any legal question
+response = client.chat("What is IPC Section 302?")
+print(response['response'])
+print(f"Tokens used: {response['usage']['total_tokens']}")
+print(f"Cost: ₹{response['usage']['cost_rupees']}")
+```
+
+## File Attachments (OpenAI-style)
+
+Attach files to your queries — just pass file paths. The SDK handles uploading automatically.
+
+```python
+# Analyze a contract — just pass the file path!
+response = client.chat(
+    "Summarize the key clauses in this contract",
+    files=["contract.pdf"]
+)
+print(response['response'])
+
+# Multiple files work too
+response = client.chat(
+    "Compare these two agreements",
+    files=["agreement_v1.pdf", "agreement_v2.pdf"]
+)
+```
+
+## Streaming (WebSocket)
+
+```python
+# Requires: pip install lawsaathi[websocket]
+for chunk in client.stream("Explain bail provisions under CrPC"):
+    print(chunk, end="", flush=True)
+
+# Streaming with files
+for chunk in client.stream("Analyze this document", files=["contract.pdf"]):
+    print(chunk, end="", flush=True)
+```
+
+## Check Balance
+
+```python
+balance = client.get_balance()
+print(f"Balance: ₹{balance['balance_rupees']}")
+print(f"Tokens available: {balance['tokens_available']:,}")
+```
+
+## Error Handling
+
+```python
+from lawsaathi import (
+    LawSaathi,
+    AuthenticationError,
+    RateLimitError,
+    InsufficientCreditsError,
+    APIError,
+)
+
+client = LawSaathi(api_key="ls_live_your_key")
+
+try:
+    response = client.chat("Hello")
+except AuthenticationError:
+    print("Invalid API key — check or regenerate it")
+except InsufficientCreditsError as e:
+    print(f"Not enough credits. Balance: ₹{e.balance_rupees}")
+except RateLimitError as e:
+    print(f"Rate limited. Retry after: {e.retry_after}s")
+except APIError as e:
+    print(f"API error ({e.status_code}): {e}")
+```
+
+## Pricing
+
+| | |
+|---|---|
+| **Cost per 1M tokens** | ₹998 |
+| **Free credits on signup** | ₹100 |
+| **Minimum topup** | ₹999 |
+| **Credit expiry** | 150 days |
+
+## Rate Limits
+
+| Limit | Default |
+|-------|---------|
+| Requests/minute | 5 |
+| Requests/day | 2,500 |
+| Max file size | 100 MB |
+
+Need higher limits? Contact support@lawsaathi.com.
+
+## Requirements
+
+- Python 3.8+
+- `requests` library (installed automatically)
+- `websocket-client` (optional, for streaming)
+
+## Links
+
+- **Dashboard**: [lawsaathi.com/developer](https://lawsaathi.com/developer)
+- **API Docs**: [lawsaathi.com/docs](https://lawsaathi.com/docs)
+- **Support**: support@lawsaathi.com
+
+## License
+
+MIT License — see [LICENSE](LICENSE) for details.

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

@@ -0,0 +1,13 @@
+LICENSE
+MANIFEST.in
+README.md
+pyproject.toml
+setup.py
+lawsaathi/__init__.py
+lawsaathi/client.py
+lawsaathi/exceptions.py
+lawsaathi.egg-info/PKG-INFO
+lawsaathi.egg-info/SOURCES.txt
+lawsaathi.egg-info/dependency_links.txt
+lawsaathi.egg-info/requires.txt
+lawsaathi.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

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

@@ -0,0 +1,12 @@
+requests>=2.25.0
+
+[dev]
+pytest>=6.0
+pytest-cov>=2.0
+black>=21.0
+flake8>=3.9
+build
+twine
+
+[websocket]
+websocket-client>=1.0.0

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

@@ -0,0 +1 @@
+lawsaathi

lawsaathi-1.0.0/pyproject.toml

@@ -0,0 +1,57 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "lawsaathi"
+version = "1.0.0"
+description = "Official Python SDK for LawSaathi Legal AI API — DELTA"
+readme = "README.md"
+license = {text = "MIT"}
+requires-python = ">=3.8"
+authors = [
+    {name = "LawSaathi", email = "support@lawsaathi.com"},
+]
+keywords = [
+    "lawsaathi", "legal-ai", "indian-law", "ipc", "crpc",
+    "delta", "ai-sdk", "legal-tech", "chatbot", "api-client",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "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",
+    "Programming Language :: Python :: 3.13",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "requests>=2.25.0",
+]
+
+[project.optional-dependencies]
+websocket = ["websocket-client>=1.0.0"]
+dev = [
+    "pytest>=6.0",
+    "pytest-cov>=2.0",
+    "black>=21.0",
+    "flake8>=3.9",
+    "build",
+    "twine",
+]
+
+[project.urls]
+Homepage = "https://lawsaathi.com"
+Documentation = "https://lawsaathi.com/docs"
+Repository = "https://github.com/lawsaathi/lawsaathi-python-sdk"
+Dashboard = "https://lawsaathi.com/developer"
+"Bug Tracker" = "https://github.com/lawsaathi/lawsaathi-python-sdk/issues"
+
+[tool.setuptools.packages.find]
+include = ["lawsaathi*"]

lawsaathi-1.0.0/setup.cfg

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

lawsaathi-1.0.0/setup.py

@@ -0,0 +1,41 @@
+from setuptools import setup, find_packages
+
+with open("README.md", "r", encoding="utf-8") as fh:
+    long_description = fh.read()
+
+setup(
+    name="lawsaathi",
+    version="1.0.0",
+    author="LawSaathi",
+    author_email="support@lawsaathi.com",
+    description="Official Python SDK for LawSaathi Legal AI API — DELTA",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    url="https://github.com/lawsaathi/lawsaathi-python-sdk",
+    packages=find_packages(),
+    classifiers=[
+        "Development Status :: 4 - Beta",
+        "Intended Audience :: Developers",
+        "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",
+    ],
+    python_requires=">=3.8",
+    install_requires=[
+        "requests>=2.25.0",
+    ],
+    extras_require={
+        "websocket": ["websocket-client>=1.0.0"],
+        "dev": [
+            "pytest>=6.0",
+            "pytest-cov>=2.0",
+            "black>=21.0",
+            "flake8>=3.9",
+        ],
+    },
+)