lawsaathi 1.0.1

Python Client for LawSaathi - The Most Capable LEGAL AI

LawSaathi Python SDK

Python Client for LawSaathi — The Most Capable LEGAL AI.

Installation

pip install lawsaathi

# With WebSocket streaming support:
pip install lawsaathi[websocket]

Quick Start

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.

# 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)

# 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

balance = client.get_balance()
print(f"Balance: ₹{balance['balance_rupees']}")
print(f"Tokens available: {balance['tokens_available']:,}")

Error Handling

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? Request a quota increase from the Developer Dashboard.

Requirements

• Python 3.8+
• requests library (installed automatically)
• websocket-client (optional, for streaming)

Links

• Dashboard: lawsaathi.com/developer
• API Docs: lawsaathi.com/docs

License

MIT License — see LICENSE for details.