bxlai 1.0.0__tar.gz

bxlai-1.0.0/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: bxlai
+Version: 1.0.0
+Summary: BX AI library for Kilo AI models
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+
+# bxAI
+
+Python library built from the supplied Kilo model catalog.
+
+Snapshot:
+- Total models: 400
+- Free models: 18
+- Token models: 382
+
+## Install
+
+```bash
+pip install requests
+```
+
+Copy `bxAI.py` and `models.json` into the same folder.
+
+## Usage
+
+Free model:
+
+```python
+from bxAI import Ai
+
+print(Ai(1, "هلو شلونك؟"))
+```
+
+Paid/token model:
+
+```python
+from bxAI import AIT
+
+print(AIT("YOUR_KILO_TOKEN", 25, "اكتبلي برنامج بايثون"))
+```
+
+Show models:
+
+```python
+from bxAI import MODLES
+
+MODLES()
+```
+
+The terminal shows only BXCode/BXL aliases and model numbers.
+Original provider/model names are not printed by `MODLES()`.
+
+## Refresh
+
+Kilo's live catalog changes. To replace the bundled snapshot:
+
+```python
+from bxAI import refresh_models
+
+print(refresh_models())
+```
+
+`refresh_models()` fetches Kilo's `/models` endpoint and regenerates the
+BXCode/BXL aliases.

bxlai-1.0.0/README.md

@@ -0,0 +1,58 @@
+# bxAI
+
+Python library built from the supplied Kilo model catalog.
+
+Snapshot:
+- Total models: 400
+- Free models: 18
+- Token models: 382
+
+## Install
+
+```bash
+pip install requests
+```
+
+Copy `bxAI.py` and `models.json` into the same folder.
+
+## Usage
+
+Free model:
+
+```python
+from bxAI import Ai
+
+print(Ai(1, "هلو شلونك؟"))
+```
+
+Paid/token model:
+
+```python
+from bxAI import AIT
+
+print(AIT("YOUR_KILO_TOKEN", 25, "اكتبلي برنامج بايثون"))
+```
+
+Show models:
+
+```python
+from bxAI import MODLES
+
+MODLES()
+```
+
+The terminal shows only BXCode/BXL aliases and model numbers.
+Original provider/model names are not printed by `MODLES()`.
+
+## Refresh
+
+Kilo's live catalog changes. To replace the bundled snapshot:
+
+```python
+from bxAI import refresh_models
+
+print(refresh_models())
+```
+
+`refresh_models()` fetches Kilo's `/models` endpoint and regenerates the
+BXCode/BXL aliases.

bxlai-1.0.0/bxAI.py

@@ -0,0 +1,306 @@
+"""
+bxAI - Lightweight Python wrapper for the Kilo AI Gateway.
+
+Public API:
+    Ai(model_number, question)
+    AIT(token, model_number, question)
+    MODLES()
+
+The display name of every model is intentionally replaced with a BXCode/BXL alias.
+The real Kilo model IDs are kept internally in models.json because the gateway
+needs the actual ID to make a request.
+
+The bundled models.json is a snapshot of the Kilo model catalog supplied with
+this package. Kilo's live catalog can change, so use refresh_models() when you
+want to replace it with the current catalog.
+"""
+
+from __future__ import annotations
+
+import json
+import os
+import shutil
+from typing import Any, Dict, List, Optional
+
+import requests
+
+BASE_URL = "https://api.kilo.ai/api/gateway"
+CHAT_URL = f"{BASE_URL}/chat/completions"
+MODELS_URL = f"{BASE_URL}/models"
+
+_PAGE_SIZE = 18
+_HERE = os.path.dirname(os.path.abspath(__file__))
+_MODELS_FILE = os.path.join(_HERE, "models.json")
+
+# Keep the catalog private to the module.
+_MODELS: List[Dict[str, Any]] = []
+
+
+def _load_models() -> None:
+    global _MODELS
+    with open(_MODELS_FILE, "r", encoding="utf-8") as f:
+        _MODELS = json.load(f)
+
+
+_load_models()
+
+
+def _find_model(number: int) -> Dict[str, Any]:
+    try:
+        number = int(number)
+    except (TypeError, ValueError):
+        raise ValueError("رقم النموذج يجب أن يكون رقمًا.")
+
+    for model in _MODELS:
+        if model["number"] == number:
+            return model
+
+    raise ValueError(f"ماكو نموذج بالرقم {number}.")
+
+
+def _request(model: Dict[str, Any], question: str, token: Optional[str] = None) -> str:
+    if not isinstance(question, str) or not question.strip():
+        raise ValueError("السؤال فارغ.")
+
+    headers = {
+        "Content-Type": "application/json",
+    }
+
+    # Kilo allows unauthenticated requests for free models.
+    if token:
+        headers["Authorization"] = f"Bearer {token.strip()}"
+
+    payload = {
+        "model": model["id"],
+        "messages": [
+            {
+                "role": "user",
+                "content": question,
+            }
+        ],
+        "stream": False,
+    }
+
+    response = requests.post(
+        CHAT_URL,
+        headers=headers,
+        json=payload,
+        timeout=90,
+    )
+
+    if response.status_code >= 400:
+        try:
+            detail = response.json()
+        except Exception:
+            detail = response.text
+
+        raise RuntimeError(
+            f"Kilo API HTTP {response.status_code}: {detail}"
+        )
+
+    data = response.json()
+
+    try:
+        content = data["choices"][0]["message"]["content"]
+    except (KeyError, IndexError, TypeError):
+        raise RuntimeError(f"استجابة غير متوقعة من Kilo: {data}")
+
+    # Some gateways/providers may return structured content.
+    if isinstance(content, list):
+        parts = []
+        for item in content:
+            if isinstance(item, dict) and "text" in item:
+                parts.append(str(item["text"]))
+            elif isinstance(item, str):
+                parts.append(item)
+        return "".join(parts)
+
+    return str(content)
+
+
+def Ai(model_number: int, question: str) -> str:
+    """
+    Ask a FREE model without a token.
+
+    Example:
+        print(Ai(1, "هلو شلونك؟"))
+    """
+    model = _find_model(model_number)
+
+    if not model["free"]:
+        raise PermissionError(
+            f"{model['alias']} نموذج غير مجاني. استخدم:\n"
+            f'AIT("YOUR_KILO_TOKEN", {model["number"]}, "السؤال")'
+        )
+
+    return _request(model, question)
+
+
+def AIT(token: str, model_number: int, question: str) -> str:
+    """
+    Ask a model using a Kilo API token.
+
+    Intended for paid/non-free models.
+
+    Example:
+        print(AIT("YOUR_TOKEN", 25, "اكتبلي كود بايثون"))
+    """
+    if not isinstance(token, str) or not token.strip():
+        raise ValueError("توكن Kilo فارغ.")
+
+    model = _find_model(model_number)
+    return _request(model, question, token=token)
+
+
+def _print_page(items: List[Dict[str, Any]], title: str, page: int, pages: int) -> None:
+    width = shutil.get_terminal_size((80, 24)).columns
+    width = max(50, min(width, 110))
+
+    print("\n" + "=" * width)
+    print(f" bxAI | {title} | صفحة {page}/{pages}")
+    print("=" * width)
+
+    for model in items:
+        status = "FREE" if model["free"] else "TOKEN"
+        print(
+            f'{model["number"]:>3} | '
+            f'{model["alias"]:<14} | '
+            f'{status}'
+        )
+
+    print("-" * width)
+
+
+def MODLES() -> None:
+    """
+    Display the complete catalog in terminal pages.
+
+    Free models are shown first.
+    Press Enter for the next page.
+    After the free section, the paid/token section is shown.
+    Press q to exit.
+    """
+    if not _MODELS:
+        print("ماكو نماذج محملة.")
+        return
+
+    sections = [
+        ("FREE MODELS", [m for m in _MODELS if m["free"]]),
+        ("TOKEN MODELS", [m for m in _MODELS if not m["free"]]),
+    ]
+
+    for section_title, items in sections:
+        if not items:
+            continue
+
+        pages = (len(items) + _PAGE_SIZE - 1) // _PAGE_SIZE
+
+        for page in range(1, pages + 1):
+            start = (page - 1) * _PAGE_SIZE
+            chunk = items[start:start + _PAGE_SIZE]
+
+            _print_page(chunk, section_title, page, pages)
+
+            if page < pages:
+                choice = input("Enter = التالي | q = خروج: ").strip().lower()
+                if choice == "q":
+                    return
+            else:
+                choice = input("Enter = القسم التالي | q = خروج: ").strip().lower()
+                if choice == "q":
+                    return
+
+    print("\nانتهت قائمة bxAI.")
+
+
+def get_model(number: int) -> Dict[str, Any]:
+    """Return internal model metadata for advanced users."""
+    return dict(_find_model(number))
+
+
+def count_models() -> Dict[str, int]:
+    """Return counts without exposing original model names."""
+    return {
+        "total": len(_MODELS),
+        "free": sum(1 for m in _MODELS if m["free"]),
+        "token": sum(1 for m in _MODELS if not m["free"]),
+    }
+
+
+def refresh_models(token: Optional[str] = None) -> Dict[str, int]:
+    """
+    Replace models.json with Kilo's current /models catalog.
+
+    GET /models does not require authentication. A token is accepted only
+    for compatibility with callers that want to pass one.
+
+    Display aliases are regenerated as BXCode-### / BXL-### and original
+    model names are never used in the MODLES() display.
+    """
+    headers = {"Content-Type": "application/json"}
+    if token:
+        headers["Authorization"] = f"Bearer {token.strip()}"
+
+    response = requests.get(MODELS_URL, headers=headers, timeout=30)
+    response.raise_for_status()
+
+    data = response.json()
+    raw = data.get("data")
+
+    if not isinstance(raw, list):
+        raise RuntimeError("Kilo /models لم يرجع قائمة نماذج.")
+
+    # Prefer Kilo's explicit isFree flag. Also accept zero prompt+completion
+    # pricing as free if the flag is absent.
+    def is_free(m: Dict[str, Any]) -> bool:
+        if m.get("isFree") is True:
+            return True
+        pricing = m.get("pricing") or {}
+        return str(pricing.get("prompt")) == "0" and str(pricing.get("completion")) == "0"
+
+    free = [m for m in raw if is_free(m)]
+    paid = [m for m in raw if not is_free(m)]
+
+    new_models = []
+
+    for idx, m in enumerate(free, 1):
+        number = idx
+        alias = f"BXCode-{number:03d}" if number % 2 else f"BXL-{number:03d}"
+        new_models.append({
+            "number": number,
+            "alias": alias,
+            "id": m["id"],
+            "free": True,
+            "context_length": m.get("context_length")
+                or m.get("top_provider", {}).get("context_length"),
+        })
+
+    start = len(free) + 1
+    for offset, m in enumerate(paid):
+        number = start + offset
+        alias = f"BXCode-{number:03d}" if number % 2 else f"BXL-{number:03d}"
+        new_models.append({
+            "number": number,
+            "alias": alias,
+            "id": m["id"],
+            "free": False,
+            "context_length": m.get("context_length")
+                or m.get("top_provider", {}).get("context_length"),
+        })
+
+    with open(_MODELS_FILE, "w", encoding="utf-8") as f:
+        json.dump(new_models, f, ensure_ascii=False, indent=2)
+
+    _load_models()
+
+    return count_models()
+
+
+__all__ = [
+    "Ai",
+    "AIT",
+    "MODLES",
+    "get_model",
+    "count_models",
+    "refresh_models",
+]

bxlai-1.0.0/bxlai.egg-info/PKG-INFO

@@ -0,0 +1,66 @@
+Metadata-Version: 2.4
+Name: bxlai
+Version: 1.0.0
+Summary: BX AI library for Kilo AI models
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+
+# bxAI
+
+Python library built from the supplied Kilo model catalog.
+
+Snapshot:
+- Total models: 400
+- Free models: 18
+- Token models: 382
+
+## Install
+
+```bash
+pip install requests
+```
+
+Copy `bxAI.py` and `models.json` into the same folder.
+
+## Usage
+
+Free model:
+
+```python
+from bxAI import Ai
+
+print(Ai(1, "هلو شلونك؟"))
+```
+
+Paid/token model:
+
+```python
+from bxAI import AIT
+
+print(AIT("YOUR_KILO_TOKEN", 25, "اكتبلي برنامج بايثون"))
+```
+
+Show models:
+
+```python
+from bxAI import MODLES
+
+MODLES()
+```
+
+The terminal shows only BXCode/BXL aliases and model numbers.
+Original provider/model names are not printed by `MODLES()`.
+
+## Refresh
+
+Kilo's live catalog changes. To replace the bundled snapshot:
+
+```python
+from bxAI import refresh_models
+
+print(refresh_models())
+```
+
+`refresh_models()` fetches Kilo's `/models` endpoint and regenerates the
+BXCode/BXL aliases.

bxlai-1.0.0/bxlai.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+README.md
+bxAI.py
+pyproject.toml
+bxlai.egg-info/PKG-INFO
+bxlai.egg-info/SOURCES.txt
+bxlai.egg-info/dependency_links.txt
+bxlai.egg-info/requires.txt
+bxlai.egg-info/top_level.txt

bxlai-1.0.0/bxlai.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

bxlai-1.0.0/bxlai.egg-info/requires.txt

@@ -0,0 +1 @@
+requests

bxlai-1.0.0/bxlai.egg-info/top_level.txt

@@ -0,0 +1 @@
+bxAI

bxlai-1.0.0/pyproject.toml

@@ -0,0 +1,14 @@
+[build-system]
+requires = ["setuptools>=61", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "bxlai"
+version = "1.0.0"
+description = "BX AI library for Kilo AI models"
+readme = "README.md"
+requires-python = ">=3.8"
+dependencies = ["requests"]
+
+[tool.setuptools]
+py-modules = ["bxAI"]

bxlai-1.0.0/setup.cfg

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