kimss 0.1.0__tar.gz

kimss-0.1.0/PKG-INFO

@@ -0,0 +1,68 @@
+Metadata-Version: 2.4
+Name: kimss
+Version: 0.1.0
+Summary: Kimss Python SDK for conversational AI agents
+License: MIT
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+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: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+
+# Kimss Python SDK
+
+Lightweight client for the [Kimss](https://kimss.ai) API. Use it to call your Kimss agents from Python scripts, backends, or notebooks.
+
+## Install
+
+```bash
+pip install kimss
+```
+
+Or from this repo (editable):
+
+```bash
+cd kimss_sdk && pip install -e .
+```
+
+## Authentication
+
+Use a **long-lived API key** (not a browser session token). Create keys in your Kimss app under **Developer Settings → API Keys**. The key is scoped to your tenant and user.
+
+## Usage
+
+```python
+from kimss import KimssClient, Agent
+
+client = KimssClient(
+    api_key="kimss_xxxxxxxxxxxxxxxxxxxxxxxx",  # from Developer Settings
+    base_url="https://api.kimss.ai",          # or your deployment URL
+)
+
+# Get an agent and send a message
+agent = client.get_agent(agent_id="asst_xxxx")
+result = agent.query("Hello")
+# result is the API "res" payload (run_id, thread_id, messages, usage, etc.)
+
+# Continue a thread
+result2 = agent.query("What did I just say?", thread_id=result.get("thread_id"))
+
+# Or use the client directly
+result3 = client.chat(assistant_id="asst_xxxx", message="Hi", thread_id=result.get("thread_id"))
+```
+
+## API
+
+- **`KimssClient(api_key, base_url="https://api.kimss.ai")`** – authenticated client.
+- **`client.get_agent(agent_id)`** – returns an `Agent` for that assistant.
+- **`agent.query(message, thread_id=None, chat_type="user_chat")`** – send a message; returns the `res` object from `POST /assistant_chat/`.
+- **`client.chat(assistant_id, message, thread_id=None, chat_type="user_chat")`** – one-off chat without an Agent handle.
+
+All requests use the `X-Kimss-Key` header. No streaming in this version; responses are full JSON.

kimss-0.1.0/README.md

@@ -0,0 +1,50 @@
+# Kimss Python SDK
+
+Lightweight client for the [Kimss](https://kimss.ai) API. Use it to call your Kimss agents from Python scripts, backends, or notebooks.
+
+## Install
+
+```bash
+pip install kimss
+```
+
+Or from this repo (editable):
+
+```bash
+cd kimss_sdk && pip install -e .
+```
+
+## Authentication
+
+Use a **long-lived API key** (not a browser session token). Create keys in your Kimss app under **Developer Settings → API Keys**. The key is scoped to your tenant and user.
+
+## Usage
+
+```python
+from kimss import KimssClient, Agent
+
+client = KimssClient(
+    api_key="kimss_xxxxxxxxxxxxxxxxxxxxxxxx",  # from Developer Settings
+    base_url="https://api.kimss.ai",          # or your deployment URL
+)
+
+# Get an agent and send a message
+agent = client.get_agent(agent_id="asst_xxxx")
+result = agent.query("Hello")
+# result is the API "res" payload (run_id, thread_id, messages, usage, etc.)
+
+# Continue a thread
+result2 = agent.query("What did I just say?", thread_id=result.get("thread_id"))
+
+# Or use the client directly
+result3 = client.chat(assistant_id="asst_xxxx", message="Hi", thread_id=result.get("thread_id"))
+```
+
+## API
+
+- **`KimssClient(api_key, base_url="https://api.kimss.ai")`** – authenticated client.
+- **`client.get_agent(agent_id)`** – returns an `Agent` for that assistant.
+- **`agent.query(message, thread_id=None, chat_type="user_chat")`** – send a message; returns the `res` object from `POST /assistant_chat/`.
+- **`client.chat(assistant_id, message, thread_id=None, chat_type="user_chat")`** – one-off chat without an Agent handle.
+
+All requests use the `X-Kimss-Key` header. No streaming in this version; responses are full JSON.

kimss-0.1.0/kimss/__init__.py

@@ -0,0 +1,4 @@
+"""Kimss Python SDK – lightweight client for Kimss conversational AI API."""
+from .client import KimssClient, Agent
+
+__all__ = ["KimssClient", "Agent"]

kimss-0.1.0/kimss/client.py

@@ -0,0 +1,73 @@
+"""
+Kimss API client and Agent wrapper.
+Use X-Kimss-Key for authentication (long-lived API key from your Kimss Developer Settings).
+"""
+from __future__ import annotations
+
+from typing import Any, Dict, Optional
+
+import requests
+
+
+class KimssClient:
+    """
+    Client for the Kimss API. Authenticate with a long-lived API key.
+    Create keys at: your Kimss app → Developer Settings → API Keys.
+    """
+
+    def __init__(self, api_key: str, base_url: str = "https://api.kimss.ai"):
+        self.api_key = api_key.strip()
+        self.base_url = base_url.rstrip("/")
+        self.headers = {"X-Kimss-Key": self.api_key, "Content-Type": "application/json"}
+
+    def get_agent(self, agent_id: str) -> "Agent":
+        """Return an Agent handle for the given assistant/agent id."""
+        return Agent(self, agent_id)
+
+    def chat(
+        self,
+        assistant_id: str,
+        message: str,
+        thread_id: Optional[str] = None,
+        chat_type: str = "user_chat",
+    ) -> Dict[str, Any]:
+        """
+        Send a message to an assistant and return the response.
+        Same as get_agent(assistant_id).query(message, thread_id).
+        """
+        return self.get_agent(assistant_id).query(message, thread_id=thread_id, chat_type=chat_type)
+
+
+class Agent:
+    """Handle for a single Kimss assistant/agent."""
+
+    def __init__(self, client: KimssClient, agent_id: str):
+        self._client = client
+        self.id = agent_id
+
+    def query(
+        self,
+        message: str,
+        thread_id: Optional[str] = None,
+        chat_type: str = "user_chat",
+    ) -> Dict[str, Any]:
+        """
+        Send a message to this agent and return the API response (res payload).
+        Optionally pass thread_id to continue a conversation.
+        """
+        payload: Dict[str, Any] = {
+            "assistant_id": self.id,
+            "usr_chat": message,
+            "chat_type": chat_type,
+        }
+        if thread_id is not None and str(thread_id).strip():
+            payload["thread_id"] = str(thread_id).strip()
+        response = requests.post(
+            f"{self._client.base_url}/assistant_chat/",
+            json=payload,
+            headers=self._client.headers,
+            timeout=120,
+        )
+        response.raise_for_status()
+        data = response.json()
+        return data.get("res", data)

kimss-0.1.0/kimss.egg-info/PKG-INFO

@@ -0,0 +1,68 @@
+Metadata-Version: 2.4
+Name: kimss
+Version: 0.1.0
+Summary: Kimss Python SDK for conversational AI agents
+License: MIT
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+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: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.28
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+
+# Kimss Python SDK
+
+Lightweight client for the [Kimss](https://kimss.ai) API. Use it to call your Kimss agents from Python scripts, backends, or notebooks.
+
+## Install
+
+```bash
+pip install kimss
+```
+
+Or from this repo (editable):
+
+```bash
+cd kimss_sdk && pip install -e .
+```
+
+## Authentication
+
+Use a **long-lived API key** (not a browser session token). Create keys in your Kimss app under **Developer Settings → API Keys**. The key is scoped to your tenant and user.
+
+## Usage
+
+```python
+from kimss import KimssClient, Agent
+
+client = KimssClient(
+    api_key="kimss_xxxxxxxxxxxxxxxxxxxxxxxx",  # from Developer Settings
+    base_url="https://api.kimss.ai",          # or your deployment URL
+)
+
+# Get an agent and send a message
+agent = client.get_agent(agent_id="asst_xxxx")
+result = agent.query("Hello")
+# result is the API "res" payload (run_id, thread_id, messages, usage, etc.)
+
+# Continue a thread
+result2 = agent.query("What did I just say?", thread_id=result.get("thread_id"))
+
+# Or use the client directly
+result3 = client.chat(assistant_id="asst_xxxx", message="Hi", thread_id=result.get("thread_id"))
+```
+
+## API
+
+- **`KimssClient(api_key, base_url="https://api.kimss.ai")`** – authenticated client.
+- **`client.get_agent(agent_id)`** – returns an `Agent` for that assistant.
+- **`agent.query(message, thread_id=None, chat_type="user_chat")`** – send a message; returns the `res` object from `POST /assistant_chat/`.
+- **`client.chat(assistant_id, message, thread_id=None, chat_type="user_chat")`** – one-off chat without an Agent handle.
+
+All requests use the `X-Kimss-Key` header. No streaming in this version; responses are full JSON.

kimss-0.1.0/kimss.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+kimss/__init__.py
+kimss/client.py
+kimss.egg-info/PKG-INFO
+kimss.egg-info/SOURCES.txt
+kimss.egg-info/dependency_links.txt
+kimss.egg-info/requires.txt
+kimss.egg-info/top_level.txt

kimss-0.1.0/kimss.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

kimss-0.1.0/kimss.egg-info/requires.txt

@@ -0,0 +1,4 @@
+requests>=2.28
+
+[dev]
+pytest>=7

kimss-0.1.0/kimss.egg-info/top_level.txt

@@ -0,0 +1 @@
+kimss

kimss-0.1.0/pyproject.toml

@@ -0,0 +1,32 @@
+[build-system]
+requires = ["setuptools>=61", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "kimss"
+version = "0.1.0"
+description = "Kimss Python SDK for conversational AI agents"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+dependencies = [
+    "requests>=2.28",
+]
+classifiers = [
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7",
+]
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["kimss*"]

kimss-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+