Metadata-Version: 2.4
Name: limely-sdk
Version: 0.0.0
Summary: Official Python client for the Limely API (chatbots, knowledge bases, forms, conversations, analytics).
Project-URL: Homepage, https://limely.co
License: MIT
Keywords: api-client,chatbot,limely,sdk
Requires-Python: >=3.9
Requires-Dist: httpx>=0.27
Description-Content-Type: text/markdown

# limely-sdk (Python)

Official Python client for the [Limely](https://limely.co) API. Manage chatbots,
knowledge bases, forms, conversations, and analytics.

## Install

```bash
pip install limely-sdk
```

Imports as `limely`.

## Auth

The Limely API authenticates with a Clerk bearer token and scopes every call to
the token owner's workspace.

```python
from limely import LimelyClient

with LimelyClient(token="...") as limely:
    types = limely.chatbot_types.list()

    kb = limely.knowledge_bases.create_from_text(
        name="Support docs",
        content="Our return window is 30 days...",
    )

    bot = limely.chatbots.create(
        name="Support bot",
        chatbot_type_id=types[0]["_id"],
        knowledge_base_ids=[kb["_id"]],
    )

    stats = limely.analytics.chatbot(bot["_id"], start="2026-06-01", end="2026-06-30")
```

## API

- `workspace.get()`
- `chatbot_types.list()`
- `chatbots.list() | get(id) | create(...) | toggle_status(id) | delete(id)`
- `knowledge_bases.list() | create_from_text(...) | delete(id)`
- `forms.list() | get(id) | create(...) | submissions(id) | templates()`
- `analytics.dashboard() | billing() | chatbot(id, start=, end=)`
- `chats.list(start_date=, end_date=) | get(session_id)`

Errors are raised as `LimelyApiError` with `.status_code` and `.body`.

## Requirements

Python >= 3.9. Depends on `httpx`.
