qanuni-sdk 0.3.0

Arabic-first legal intelligence SDK for Saudi-focused legal workflows.

Qanuni SDK

Qanuni is an Arabic-first Python SDK for Saudi legal workflows.

It supports two usage styles in one package:

• direct legal tools for focused tasks
• workflows and a deterministic legal agent for harder multi-step matters

Install

python -m pip install --upgrade qanuni-sdk

Optional MCP support:

python -m pip install "qanuni-sdk[mcp]"

Quickstart

from qanuni import LegalClient

client = LegalClient()

result = client.contracts.gap_analysis(
    contract_text="""
    يلتزم الطرف الثاني بتنفيذ الأعمال،
    ويتم السداد لاحقًا وفق ما يراه الطرف الأول مناسبًا،
    ويجوز إنهاء العقد عند الحاجة.
    """,
    contract_type="service_agreement",
)

print(result.summary)

Workflow Example

workflow_result = client.workflow.contract_review(
    document_text="""
    اتفق الطرف الأول مع الطرف الثاني على تقديم خدمات تقنية،
    ويتم السداد بعد الفاتورة، ويجوز إنهاء العقد عند الحاجة.
    """,
    contract_type="service_agreement",
)

print(workflow_result.executive_summary)
print(workflow_result.risk_level)

Agent Example

agent_result = client.agent.run(
    goal="راجع العقد وحدد المخاطر ثم جهز تصورًا لمطالبة قانونية مناسبة.",
    documents=[
        {
            "name": "contract.md",
            "text": """
            اتفق الطرف الأول مع الطرف الثاني على تقديم خدمات تقنية،
            ويتم السداد بعد الفاتورة، ويجوز إنهاء العقد عند الحاجة.
            """,
        }
    ],
)

print(agent_result.status)
print(agent_result.answer_text)

Included Surfaces

• tools: labor, legal, contracts, compliance, drafting, policies
• workflows: client.workflow
• agent runtime: client.agent
• optional signed-license operations: client.license
• acceptance CLI and human-testing examples
• optional MCP server

Built-in Operational Features

• structured outputs
• cost estimation
• selective caching
• observability events
• dated agent logs

Optional Commands

qanuni-examples --list
qanuni-acceptance --list
qanuni-mcp-smoke --mode mocked
qanuni-mcp-server serve --host 127.0.0.1 --port 8088