Metadata-Version: 2.4
Name: zainahmed-sdk
Version: 1.0.0
Summary: Official Python SDK for Zain Ahmed's Cloud Architecture, DevSecOps & Agent API
Author-email: Zain Ahmed <hello@zainahmed.net>
License: MIT
Project-URL: Homepage, https://zainahmed.net
Project-URL: Documentation, https://zainahmed.net/docs
Project-URL: Repository, https://github.com/thezaynahmed/portfolio
Keywords: zainahmed,cloud-architecture,sre,mcp,agentic-ai,sdk
Classifier: Programming Language :: Python :: 3
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 :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.24.0
Dynamic: license-file

# zainahmed-sdk

Official Python SDK for [Zain Ahmed's Cloud Architecture & Platform API](https://zainahmed.net).

[![PyPI version](https://img.shields.io/pypi/v/zainahmed-sdk.svg)](https://pypi.org/project/zainahmed-sdk/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)

## Installation

```bash
pip install zainahmed-sdk
```

## Quickstart

### Synchronous Usage

```python
from zainahmed import ZainClient

client = ZainClient()

# Get verified engineer profile and credentials
profile = client.get_profile()
print(f"Name: {profile['name']}, Title: {profile['title']}")

# List case studies
projects = client.list_projects(category="kubernetes")
print(f"Projects found: {len(projects.get('projects', []))}")

# Natural Language Query (NLWeb)
answer = client.ask("What are Zain's core areas of cloud architecture?")
print(f"Answer: {answer['answer']}")
```

### Asynchronous Usage

```python
import asyncio
from zainahmed import AsyncZainClient

async def main():
    async with AsyncZainClient() as client:
        profile = await client.get_profile()
        print(f"Connected to {profile['name']}")

asyncio.run(main())
```

## License

MIT © Zain Ahmed
