Metadata-Version: 2.4
Name: kricko
Version: 0.1.0
Summary: Run AI. Offline. Everywhere. Official Python SDK and CLI for Kricko local LLM engine by Cortiqa.
Author-email: Cortiqa <dev@cortiqa.co>
License: Apache-2.0
Project-URL: Homepage, https://cortiqa.co
Project-URL: Documentation, https://github.com/cortiqa/kricko
Project-URL: Repository, https://github.com/cortiqa/kricko.git
Keywords: llm,offline,ai,gguf,llama,inference,cortiqa,openai
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
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: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.25.0
Requires-Dist: rich>=13.0.0
Requires-Dist: typer>=0.9.0
Requires-Dist: pydantic>=2.0.0
Dynamic: license-file

# 🟢 Kricko Python SDK (`pip install kricko`)

> **Run AI. Offline. Everywhere.** Official Python SDK and CLI for Kricko local LLM engine by [Cortiqa](https://cortiqa.co).

[![PyPI Version](https://img.shields.io/pypi/v/kricko.svg)](https://pypi.org/project/kricko/)
[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](LICENSE)
[![Python Versions](https://img.shields.io/pypi/pyversions/kricko.svg)](https://pypi.org/project/kricko/)

---

## ⚡ Installation

```bash
pip install kricko
```

---

## 🚀 Quick Start in Python

### 1. Basic Chat
```python
import kricko

# Chat directly with Gemma 2B or your loaded model
response = kricko.chat("Explain quantum computing in one sentence")
print(response)
```

### 2. Streaming Tokens (Real-time generation)
```python
import kricko

model = kricko.load("gemma-2b")

for token in model.stream("Tell me a motivational quote in Hindi"):
    print(token, end="", flush=True)
print()
```

### 3. Model Management & Server
```python
import kricko

# Download a model
kricko.pull("gemma-2b")

# Start OpenAI-compatible REST server (http://localhost:8080)
kricko.serve(model="gemma-2b", port=8080)
```

---

## 💻 Python CLI Commands

After running `pip install kricko`, the `kricko` command is available in your shell:

```bash
kricko version           # Show version and engine status
kricko list              # List installed & available models
kricko pull gemma-2b     # Download model weights
kricko run gemma-2b      # Start terminal chat session
kricko serve             # Start local OpenAI server
```

---

## 📄 License

Apache-2.0 © [Cortiqa](https://cortiqa.co).
