Metadata-Version: 2.4
Name: pakllm-coder
Version: 1.2.0
Summary: Sovereign AI Coding Agent Python SDK for Project Pak-LLM Coder (coder.pak-llm.com)
Home-page: https://coder.pak-llm.com/sdk
Author: SBF Consultancy
Author-email: SBF Consultancy <info@sbf-consultancy.net>
License: Apache-2.0
Project-URL: Homepage, https://coder.pak-llm.com/sdk
Project-URL: Documentation, https://coder.pak-llm.com/sdk
Project-URL: Repository, https://coder.pak-llm.com
Keywords: ai,pakllm,coder,sovereign-ai,autonomous-agent,codeact,ast,sdk
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: Programming Language :: Python :: 3.14
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.24.0
Dynamic: author
Dynamic: home-page
Dynamic: requires-python

# 🇵🇰 Pak-LLM Coder Python SDK (`pakllm-coder`)

Official Sovereign AI Coding Agent Python SDK for **Pak-LLM Coder** ([coder.pak-llm.com](https://coder.pak-llm.com)).

## Installation

### Method 1: Local Monorepo Install (Instant)
```bash
pip install -e D:/Pak-LLM_Coder/packages/sdk/python
# Or direct folder install
pip install D:/Pak-LLM_Coder/packages/sdk/python
```

### Method 2: Sovereign Direct URL / Wheel
```bash
pip install https://coder.pak-llm.com/downloads/packages/pakllm_coder-1.2.0-py3-none-any.whl
```

### Method 3: PyPI (When published)
```bash
pip install pakllm-coder
```

---

## Quickstart

```python
import asyncio
import sys
from pakllm_coder import Agent, LocalAgentConfig, CapabilitiesConfig

async def main():
    # Sovereign async context manager pattern
    config = LocalAgentConfig(
        system_instructions="You are an autonomous Python engineer.",
        capabilities=CapabilitiesConfig(allow_bash_execution=True)
    )

    async with Agent(config) as agent:
        response = await agent.chat("Write an async FastAPI router with rate-limiting.")

        async for token in response:
            sys.stdout.write(token)
            sys.stdout.flush()

if __name__ == "__main__":
    asyncio.run(main())
```

---

## Sovereign Architecture & Ethics
- **Zero Cloud Code Retention**: Code is processed in memory and never persisted for upstream model training.
- **Islamic Shariah Compliance**: In-flight Prompt Security Sentinel strictly filters Riba, gambling, fraud, and illegal exploits.
- **Domestic Rails**: Metered with 0% Riba payment rails via Swich domestic payment gateway (JazzCash, EasyPaisa, 1Link IBFT).

Architected by **SBF Consultancy** ([sbf-consultancy.net](https://sbf-consultancy.net)).
