Metadata-Version: 2.4
Name: kyma-ai
Version: 0.1.0
Summary: Official Kyma API client — free LLM API gateway. Every open source model, one endpoint.
Author: Kyma API
License: MIT
Project-URL: Homepage, https://kymaapi.com
Project-URL: Documentation, https://docs.kymaapi.com
Project-URL: Repository, https://github.com/sonpiaz/kyma-api
Keywords: kyma,llm,ai,openai,api,free,open-source,chat
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: openai>=1.0.0
Requires-Dist: httpx>=0.24.0

# kyma-ai

Official Python client for [Kyma API](https://kymaapi.com) — free LLM API gateway. Every open source model, one endpoint.

## Install

```bash
pip install kyma-ai
```

## Quick Start

```python
from kyma_ai import Kyma

kyma = Kyma(api_key="kyma-your-key")

# Simple: ask a question
reply = kyma.ask("Explain quantum computing simply")
print(reply)

# Streaming
for chunk in kyma.ask_stream("Write a poem"):
    print(chunk, end="", flush=True)

# Full control: OpenAI-compatible chat
response = kyma.chat.completions.create(
    model="llama-3.3-70b",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello!"},
    ],
)
print(response.choices[0].message.content)
```

## Available Models

```python
models = kyma.list_models()
for m in models:
    print(m["id"], m.get("name"))
```

20+ models from Meta, Google, Alibaba, OpenAI, NVIDIA, and more. All free to start.

## Check Balance

```python
info = kyma.get_balance()
print(f"Balance: ${info['balance']:.2f}")
```

## OpenAI SDK Compatible

Kyma wraps the official OpenAI SDK. Access it directly:

```python
openai_client = kyma.openai
# Use any OpenAI SDK feature
```

## Get Your API Key

1. Sign up at [kymaapi.com](https://kymaapi.com)
2. Get your `kyma-` API key from the dashboard
3. Start building!

## Links

- [Dashboard](https://kymaapi.com/dashboard)
- [Docs](https://docs.kymaapi.com)
- [Models](https://kymaapi.com/v1/models)
- [Status](https://kymaapi.com/status)
