Metadata-Version: 2.4
Name: idliappam
Version: 1.0.0
Summary: Python SDK for AI Commerce OS — WhatsApp, invoicing, inventory, loyalty, support
Home-page: https://github.com/Ankitajainkuniya/ai-commerce-os
Author: Idliappam
Author-email: hello@idliapam.in
License: MIT
Project-URL: Documentation, https://idliapam.in/chutney
Project-URL: Source, https://github.com/Ankitajainkuniya/ai-commerce-os/tree/main/packages/chutney-python
Keywords: commerce api sdk whatsapp invoicing ai idliappam chutney india
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.25.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# idliappam

**Python SDK for AI Commerce OS. One SDK for WhatsApp, invoicing, inventory, loyalty, and support â€” built for Indian commerce.**

[![License: MIT](https://img.shields.io/badge/License-MIT-violet.svg)](https://opensource.org/licenses/MIT)
[![Python 3.7+](https://img.shields.io/badge/python-3.7+-blue.svg)](https://www.python.org/downloads/)

---

## Install

```bash
pip install idliappam
```

## Quick Start

```python
from idliappam import Chutney

client = Chutney(api_key='chutney_sk_xxx', brand_id='brand_xxx')

# Send WhatsApp message
client.whatsapp.send(to='+919876543210', message='Your order has been shipped!')

# Create GST invoice
invoice = client.invoices.create(
    customer_name='Priya Sharma',
    customer_email='priya@example.com',
    items=[
        {'description': 'Scented Candle', 'quantity': 2, 'price': 499},
        {'description': 'Gift Box', 'quantity': 1, 'price': 199},
    ]
)

# Check low stock
products = client.inventory.list(low_stock_only=True)

# Enroll in loyalty program
client.loyalty.enroll(
    customer_name='Priya Sharma',
    customer_phone='+919876543210'
)

# Award loyalty points
client.loyalty.award_points(phone='+919876543210', points=100, reason='Purchase')

# Create support ticket
client.support.create_ticket(
    subject='Wrong item received',
    description='Ordered red candle but received blue',
    customer_email='priya@example.com'
)

# Ask AI Copilot
answer = client.ai.ask('What are my top selling products this month?')
```

## Available APIs

| Module | Methods | Description |
|--------|---------|-------------|
| `client.whatsapp` | `send()`, `get_conversations()`, `get_templates()` | WhatsApp messaging |
| `client.invoices` | `create()`, `list()`, `mark_paid()`, `send()` | GST invoicing |
| `client.inventory` | `list()`, `create()`, `update_stock()`, `dashboard()` | Stock management |
| `client.loyalty` | `enroll()`, `award_points()`, `lookup()`, `get_program()` | Loyalty program |
| `client.support` | `create_ticket()`, `list_tickets()`, `get_ai_suggestion()` | AI support |
| `client.leads` | `create()`, `list()` | Lead management |
| `client.orders` | `create()`, `list()` | Order management |
| `client.ai` | `ask()` | AI Copilot |

## JavaScript SDK

Also available for JavaScript/TypeScript:
```bash
npm install @idliapam/chutney-js
```

See: [github.com/Ankitajainkuniya/chutney-js](https://github.com/Ankitajainkuniya/chutney-js)

## License

MIT

---

Built by [Idliapam](https://idliapam.in) â€” the unified AI platform for Indian commerce.
