klyuchora 0.2.0__tar.gz

klyuchora-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Klyuchora
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

klyuchora-0.2.0/PKG-INFO

@@ -0,0 +1,63 @@
+Metadata-Version: 2.4
+Name: klyuchora
+Version: 0.2.0
+Summary: SDK Ключоры для Python: все модели, стриминг, лимиты ключей, баланс кабинета. Сайт: https://klyuchora.ru
+Home-page: https://klyuchora.ru
+Author: Klyuchora
+License: MIT
+Project-URL: Homepage, https://klyuchora.ru
+Project-URL: Documentation, https://klyuchora.ru/sdk
+Keywords: klyuchora,ключора,llm,api,sdk,ai
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# klyuchora
+
+Официальный SDK сервиса [Ключора](https://klyuchora.ru) для Python. Без зависимостей, Python 3.8+.
+Чат и стриминг, все типы моделей, список доступных моделей, лимиты ключа, баланс кабинета, оценка стоимости запроса, async и командная строка.
+
+Сайт: https://klyuchora.ru · Документация: https://klyuchora.ru/sdk
+
+## Установка
+
+    pip install klyuchora
+
+## Быстрый старт
+
+Ключ создаётся в кабинете на https://klyuchora.ru (раздел «Ключи API»). Положите его в переменную окружения `KLYUCHORA_API_KEY`.
+
+```python
+from klyuchora import Klyuchora
+
+client = Klyuchora()  # ключ берётся из KLYUCHORA_API_KEY
+reply = client.chat.completions.create(
+    model="gpt-4o-mini",
+    messages=[{"role": "user", "content": "Привет!"}],
+)
+print(reply.choices[0].message.content)
+
+# стриминг
+with client.chat.completions.create(model="gpt-4o-mini", messages=[{"role": "user", "content": "Расскажи шутку"}], stream=True) as stream:
+    for text in stream.text_deltas():
+        print(text, end="", flush=True)
+
+print(client.models.ids())        # модели, доступные вашему ключу
+print(client.key.usage())         # лимиты и расход ключа
+print(client.account.balance())   # баланс кабинета (нужен KLYUCHORA_ACCESS_TOKEN)
+print(client.estimate_cost("gpt-4o-mini", input_tokens=1000, output_tokens=500))
+```
+
+Асинхронный клиент: `AsyncKlyuchora`. Командная строка:
+`klyuchora models | price МОДЕЛЬ | usage | balance | keys | rate | chat МОДЕЛЬ "текст"`.
+
+Полная документация с примерами для всех методов: https://klyuchora.ru/sdk
+
+## Лицензия
+
+MIT

klyuchora-0.2.0/README.md

@@ -0,0 +1,44 @@
+# klyuchora
+
+Официальный SDK сервиса [Ключора](https://klyuchora.ru) для Python. Без зависимостей, Python 3.8+.
+Чат и стриминг, все типы моделей, список доступных моделей, лимиты ключа, баланс кабинета, оценка стоимости запроса, async и командная строка.
+
+Сайт: https://klyuchora.ru · Документация: https://klyuchora.ru/sdk
+
+## Установка
+
+    pip install klyuchora
+
+## Быстрый старт
+
+Ключ создаётся в кабинете на https://klyuchora.ru (раздел «Ключи API»). Положите его в переменную окружения `KLYUCHORA_API_KEY`.
+
+```python
+from klyuchora import Klyuchora
+
+client = Klyuchora()  # ключ берётся из KLYUCHORA_API_KEY
+reply = client.chat.completions.create(
+    model="gpt-4o-mini",
+    messages=[{"role": "user", "content": "Привет!"}],
+)
+print(reply.choices[0].message.content)
+
+# стриминг
+with client.chat.completions.create(model="gpt-4o-mini", messages=[{"role": "user", "content": "Расскажи шутку"}], stream=True) as stream:
+    for text in stream.text_deltas():
+        print(text, end="", flush=True)
+
+print(client.models.ids())        # модели, доступные вашему ключу
+print(client.key.usage())         # лимиты и расход ключа
+print(client.account.balance())   # баланс кабинета (нужен KLYUCHORA_ACCESS_TOKEN)
+print(client.estimate_cost("gpt-4o-mini", input_tokens=1000, output_tokens=500))
+```
+
+Асинхронный клиент: `AsyncKlyuchora`. Командная строка:
+`klyuchora models | price МОДЕЛЬ | usage | balance | keys | rate | chat МОДЕЛЬ "текст"`.
+
+Полная документация с примерами для всех методов: https://klyuchora.ru/sdk
+
+## Лицензия
+
+MIT

klyuchora-0.2.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["setuptools>=61"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "klyuchora"
+version = "0.2.0"
+description = "SDK Ключоры для Python: все модели, стриминг, лимиты ключей, баланс кабинета. Сайт: https://klyuchora.ru"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "Klyuchora" }]
+keywords = ["klyuchora", "ключора", "llm", "api", "sdk", "ai"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Typing :: Typed",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://klyuchora.ru"
+Documentation = "https://klyuchora.ru/sdk"
+
+[project.scripts]
+klyuchora = "klyuchora.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+klyuchora = ["py.typed"]

klyuchora-0.2.0/setup.cfg

@@ -0,0 +1,41 @@
+[metadata]
+name = klyuchora
+version = attr: klyuchora._version.__version__
+description = SDK Ключоры для Python: все модели, стриминг, лимиты ключей, баланс кабинета. Сайт: https://klyuchora.ru
+long_description = file: README.md
+long_description_content_type = text/markdown
+keywords = klyuchora, ключора, llm, api, sdk, ai
+url = https://klyuchora.ru
+project_urls = 
+	Документация = https://klyuchora.ru/sdk
+	Сайт = https://klyuchora.ru
+author = Klyuchora
+license = MIT
+license_files = LICENSE
+classifiers = 
+	Programming Language :: Python :: 3
+	License :: OSI Approved :: MIT License
+	Operating System :: OS Independent
+	Typing :: Typed
+
+[options]
+package_dir = =src
+packages = find:
+python_requires = >=3.8
+zip_safe = False
+include_package_data = True
+
+[options.packages.find]
+where = src
+
+[options.package_data]
+klyuchora = py.typed
+
+[options.entry_points]
+console_scripts = 
+	klyuchora = klyuchora.cli:main
+
+[egg_info]
+tag_build = 
+tag_date = 0
+

klyuchora-0.2.0/setup.py

@@ -0,0 +1,2 @@
+from setuptools import setup
+setup()

klyuchora-0.2.0/src/klyuchora/__init__.py

@@ -0,0 +1,22 @@
+"""Klyuchora SDK: one client for chat, responses, embeddings, images, audio, models, key limits and balance."""
+from ._client import Klyuchora
+from ._errors import (APIError, AuthenticationError, BadRequestError, ConnectionFailed,
+                      InsufficientBalanceError, KlyuchoraError, NotFoundError, PermissionDeniedError,
+                      RateLimitError, RequestTimeout, ServerError)
+from ._obj import Obj
+from ._stream import ChatStream, Stream
+from ._version import __version__
+
+__all__ = [
+    "Klyuchora", "AsyncKlyuchora", "Stream", "ChatStream", "Obj", "__version__",
+    "KlyuchoraError", "APIError", "AuthenticationError", "BadRequestError", "ConnectionFailed",
+    "InsufficientBalanceError", "NotFoundError", "PermissionDeniedError", "RateLimitError",
+    "RequestTimeout", "ServerError",
+]
+
+
+def __getattr__(name):  # lazy: asyncio is only imported when needed
+    if name == "AsyncKlyuchora":
+        from ._async import AsyncKlyuchora
+        return AsyncKlyuchora
+    raise AttributeError(name)

klyuchora-0.2.0/src/klyuchora/__main__.py

@@ -0,0 +1,3 @@
+import sys
+from .cli import main
+sys.exit(main())

klyuchora-0.2.0/src/klyuchora/_async.py

@@ -0,0 +1,99 @@
+"""Async interface. Calls run in worker threads, so it works on any asyncio loop with no extra packages."""
+import asyncio
+import functools
+from typing import Any, AsyncIterator, Optional
+
+from ._client import Klyuchora
+from ._stream import ChatStream, Stream
+
+
+async def _run(fn, *args, **kwargs):
+    loop = asyncio.get_running_loop()
+    return await loop.run_in_executor(None, functools.partial(fn, *args, **kwargs))
+
+
+class AsyncStream:
+    """``async for`` over a :class:`Stream`."""
+
+    def __init__(self, stream: Stream):
+        self._stream = stream
+        self.request_id = stream.request_id
+
+    def __aiter__(self) -> "AsyncStream":
+        return self
+
+    async def __anext__(self) -> Any:
+        def step():
+            try:
+                return next(self._stream), False
+            except StopIteration:
+                return None, True
+        item, done = await _run(step)
+        if done:
+            raise StopAsyncIteration
+        return item
+
+    async def text_deltas(self) -> AsyncIterator[str]:
+        async for chunk in self:
+            for choice in chunk.get("choices") or []:
+                piece = (choice.get("delta") or {}).get("content")
+                if piece:
+                    yield piece
+
+    async def collect(self) -> Any:
+        if isinstance(self._stream, ChatStream):
+            return await _run(self._stream.collect)
+        return [event async for event in self]
+
+    async def aclose(self) -> None:
+        await _run(self._stream.close)
+
+    async def __aenter__(self) -> "AsyncStream":
+        return self
+
+    async def __aexit__(self, *exc: Any) -> None:
+        await self.aclose()
+
+
+class _AsyncProxy:
+    def __init__(self, target: Any):
+        self._target = target
+
+    def __getattr__(self, name: str) -> Any:
+        attr = getattr(self._target, name)
+        if callable(attr):
+            @functools.wraps(attr)
+            async def call(*args: Any, **kwargs: Any) -> Any:
+                result = await _run(attr, *args, **kwargs)
+                return AsyncStream(result) if isinstance(result, Stream) else result
+            return call
+        if hasattr(attr, "__dict__") and not isinstance(attr, (str, int, float, bool, list, dict)):
+            return _AsyncProxy(attr)
+        return attr
+
+
+class AsyncKlyuchora:
+    """Same API as :class:`Klyuchora`, every method is awaited:
+
+        client = AsyncKlyuchora()
+        reply = await client.chat.completions.create(model="...", messages=[...])
+        stream = await client.chat.completions.create(model="...", messages=[...], stream=True)
+        async for text in stream.text_deltas(): ...
+    """
+
+    def __init__(self, *args: Any, **kwargs: Any):
+        self._sync = Klyuchora(*args, **kwargs)
+        for name in ("chat", "completions", "responses", "messages", "embeddings", "images", "audio",
+                     "rerank", "moderations", "models", "key", "account", "rates"):
+            setattr(self, name, _AsyncProxy(getattr(self._sync, name)))
+
+    @property
+    def base_url(self) -> str:
+        return self._sync.base_url
+
+    async def estimate_cost(self, *args: Any, **kwargs: Any) -> Any:
+        return await _run(self._sync.estimate_cost, *args, **kwargs)
+
+    async def request(self, *args: Any, **kwargs: Any) -> Any:
+        result = await _run(self._sync.request, *args, **kwargs)
+        return AsyncStream(result) if isinstance(result, Stream) else result