Metadata-Version: 2.4
Name: tajikgpt
Version: 1.1.0
Summary: Official Python SDK for TajikGPT API — chat, images, and video generation
Author-email: SoulLab <support@soullab.space>
License: MIT
Project-URL: Homepage, https://tajikgpt.com
Project-URL: Documentation, https://tajikgpt.com/docs
Project-URL: Repository, https://github.com/soullab/tajikgpt-python
Keywords: tajikgpt,ai,chatbot,api,sdk
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
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 :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.20.0

# TajikGPT Python SDK

Official Python client for [TajikGPT API](https://tajikgpt.com/docs).

## Installation

```bash
pip install tajikgpt
```

## Quick Start

```python
from tajikgpt import TajikGPT

client = TajikGPT(api_key="sk-tj-your-key")

# Chat
response = client.chat.completions.create(
    model="tj-1.0",
    messages=[{"role": "user", "content": "Привет!"}]
)
print(response.choices[0].message.content)

# Image generation
image = client.images.generate(
    prompt="Sunset over Tajikistan mountains",
    image_model="tj-image-1.0"
)
print(image.url)

# Video generation (Plus/Pro only)
video = client.video.generate(
    prompt="A beautiful mountain landscape timelapse"
)
print(video.url)
```

## Models

| Model | Description | Tier |
|-------|-------------|------|
| `tj-0.5` | Legacy | Free |
| `tj-1.0-mini` | Fast, simple tasks | Free |
| `tj-1.0` | Balanced speed & quality | Free |
| `tj-1.0-pro` | Smart + Vision, Web Search | Plus+ |
| `tj-1.0-ultra` | Top model | Plus+ |
| `tj-coder` | Code assistant | Free |
| `tj-image-1.0` | High quality images | All |
| `tj-image-0.5` | Legacy images | All |
| `tj-video-1.0` | Video generation (Alpha) | Plus/Pro |

## Error Handling

```python
from tajikgpt import TajikGPT, AuthenticationError, RateLimitError

client = TajikGPT(api_key="sk-tj-your-key")

try:
    response = client.chat.completions.create(
        model="tj-1.0",
        messages=[{"role": "user", "content": "Hello"}]
    )
except AuthenticationError:
    print("Invalid API key")
except RateLimitError:
    print("Too many requests, wait and retry")
```

## Get API Key

1. Go to [tajikgpt.com/pricing](https://tajikgpt.com/pricing)
2. Subscribe to Pro plan
3. Find your API key in [profile](https://tajikgpt.com/profile)

## Links

- [API Documentation](https://tajikgpt.com/docs)
- [Website](https://tajikgpt.com)
- [SoulLab](https://soullab.space)
