brsxcloud 0.1.0__tar.gz

brsxcloud-0.1.0/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: brsxcloud
+Version: 0.1.0
+Summary: BRSX-Cloud için resmi Python client — chat edilebilir modellere API key ile erişim
+Author: BRSX Labs
+License: MIT
+Project-URL: Homepage, https://cloud.brsxlabs.com
+Project-URL: Documentation, https://help.brsxlabs.com
+Project-URL: Repository, https://brsxlabs.com
+Keywords: brsx,brsx-cloud,ai,chat,api-client
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT 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
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# brsxcloud
+
+[BRSX-Cloud](https://cloud.brsxlabs.com) için resmi Python client. Chat edilebilir olarak paylaşılmış modellere kendi API key'inle, kod içinden erişmeni sağlar.
+
+## Kurulum
+
+```bash
+pip install brsxcloud
+```
+
+## API Key Alma
+
+1. [cloud.brsxlabs.com](https://cloud.brsxlabs.com) adresinde giriş yap.
+2. Sol menüden **Kullanıcı Paneli**'ni aç.
+3. **API Anahtarların** bölümünden **+ Yeni Key** ile bir key oluştur.
+4. Key sadece o an gösterilir, hemen kopyala — bir daha görüntülenmez.
+
+Her key için günlük istek limiti vardır (panelde görebilirsin).
+
+## Kullanım
+
+```python
+from brsxcloud import Client
+
+client = Client("brsxk_...")  # kendi API key'in
+
+reply = client.chat(model_id=1, message="Merhaba, nasılsın?")
+print(reply)
+```
+
+`model_id`'yi, BRSX-Cloud'daki **Modeller** sekmesinde ilgili modelin sayfasından ya da model sahibinin sana verdiği id'den öğrenebilirsin.
+
+## Hata Yönetimi
+
+```python
+from brsxcloud import Client, BrsxCloudError
+
+client = Client("brsxk_...")
+
+try:
+    reply = client.chat(model_id=1, message="Selam")
+except BrsxCloudError as e:
+    print(f"Hata: {e.message} (durum kodu: {e.status_code})")
+```
+
+Olası hatalar: geçersiz/iptal edilmiş API key, günlük kota aşımı, model bulunamadı, model chat için paylaşılmamış, model çalıştırılırken hata.
+
+## Lisans
+
+MIT

brsxcloud-0.1.0/README.md

@@ -0,0 +1,50 @@
+# brsxcloud
+
+[BRSX-Cloud](https://cloud.brsxlabs.com) için resmi Python client. Chat edilebilir olarak paylaşılmış modellere kendi API key'inle, kod içinden erişmeni sağlar.
+
+## Kurulum
+
+```bash
+pip install brsxcloud
+```
+
+## API Key Alma
+
+1. [cloud.brsxlabs.com](https://cloud.brsxlabs.com) adresinde giriş yap.
+2. Sol menüden **Kullanıcı Paneli**'ni aç.
+3. **API Anahtarların** bölümünden **+ Yeni Key** ile bir key oluştur.
+4. Key sadece o an gösterilir, hemen kopyala — bir daha görüntülenmez.
+
+Her key için günlük istek limiti vardır (panelde görebilirsin).
+
+## Kullanım
+
+```python
+from brsxcloud import Client
+
+client = Client("brsxk_...")  # kendi API key'in
+
+reply = client.chat(model_id=1, message="Merhaba, nasılsın?")
+print(reply)
+```
+
+`model_id`'yi, BRSX-Cloud'daki **Modeller** sekmesinde ilgili modelin sayfasından ya da model sahibinin sana verdiği id'den öğrenebilirsin.
+
+## Hata Yönetimi
+
+```python
+from brsxcloud import Client, BrsxCloudError
+
+client = Client("brsxk_...")
+
+try:
+    reply = client.chat(model_id=1, message="Selam")
+except BrsxCloudError as e:
+    print(f"Hata: {e.message} (durum kodu: {e.status_code})")
+```
+
+Olası hatalar: geçersiz/iptal edilmiş API key, günlük kota aşımı, model bulunamadı, model chat için paylaşılmamış, model çalıştırılırken hata.
+
+## Lisans
+
+MIT

brsxcloud-0.1.0/brsxcloud/__init__.py

@@ -0,0 +1,113 @@
+"""
+brsxcloud — BRSX-Cloud için resmi Python client.
+
+Kurulum:
+    pip install brsxcloud
+
+Kullanım:
+    from brsxcloud import Client
+
+    client = Client("brsxk_...")  # panelden aldığın API key
+    reply = client.chat(model_id=1, message="Merhaba!")
+    print(reply)
+"""
+
+from __future__ import annotations
+
+import json
+import urllib.error
+import urllib.request
+
+__version__ = "0.1.0"
+__all__ = ["Client", "BrsxCloudError"]
+
+DEFAULT_BASE_URL = "https://cloud.brsxlabs.com"
+
+
+class BrsxCloudError(Exception):
+    """BRSX-Cloud API'sinden dönen bir hata. `status_code` ve `message`
+    attribute'ları vardır — ör. kota aşımı, geçersiz key, model bulunamadı."""
+
+    def __init__(self, message: str, status_code: int | None = None):
+        super().__init__(message)
+        self.message = message
+        self.status_code = status_code
+
+    def __str__(self) -> str:
+        if self.status_code:
+            return f"[{self.status_code}] {self.message}"
+        return self.message
+
+
+class Client:
+    """BRSX-Cloud API'sine bağlanan basit bir client.
+
+    Args:
+        api_key: Panelden ("Kullanıcı Paneli" > "API Anahtarların")
+            aldığın, `brsxk_` ile başlayan API key.
+        base_url: Genelde değiştirmene gerek yok, testler için var.
+        timeout: Saniye cinsinden istek zaman aşımı (varsayılan 60 —
+            model inference'ı CPU'da yavaş olabilir).
+    """
+
+    def __init__(self, api_key: str, base_url: str = DEFAULT_BASE_URL, timeout: float = 60.0):
+        if not api_key or not api_key.startswith("brsxk_"):
+            raise ValueError(
+                "Geçersiz api_key — 'brsxk_' ile başlayan bir key gerekli. "
+                "Panelden (Kullanıcı Paneli > API Anahtarların) alabilirsin."
+            )
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+
+    def chat(self, model_id: int, message: str) -> str:
+        """Chat edilebilir bir modele mesaj gönderir, cevabı döner.
+
+        Args:
+            model_id: BRSX-Cloud'daki model id'si (Modeller sekmesinde
+                bir modelin üzerine tıklayınca ya da API listesinden
+                görebilirsin).
+            message: Modele gönderilecek metin.
+
+        Returns:
+            Modelin ürettiği cevap (str).
+
+        Raises:
+            BrsxCloudError: Kota aşımı, geçersiz key, model bulunamadı,
+                model chat için paylaşılmamış, ya da model çalıştırılırken
+                hata oluşursa.
+        """
+        if not message or not message.strip():
+            raise ValueError("message boş olamaz.")
+
+        url = f"{self.base_url}/api/cloud/v1/chat/{model_id}"
+        body = json.dumps({"message": message}).encode("utf-8")
+
+        req = urllib.request.Request(
+            url,
+            data=body,
+            method="POST",
+            headers={
+                "Content-Type": "application/json",
+                "Authorization": f"Bearer {self.api_key}",
+                "User-Agent": f"brsxcloud-python/{__version__}",
+            },
+        )
+
+        try:
+            with urllib.request.urlopen(req, timeout=self.timeout) as resp:
+                data = json.loads(resp.read().decode("utf-8"))
+        except urllib.error.HTTPError as e:
+            try:
+                data = json.loads(e.read().decode("utf-8"))
+                message_text = data.get("error", str(e))
+            except (json.JSONDecodeError, UnicodeDecodeError):
+                message_text = str(e)
+            raise BrsxCloudError(message_text, status_code=e.code) from None
+        except urllib.error.URLError as e:
+            raise BrsxCloudError(f"Sunucuya ulaşılamadı: {e.reason}") from None
+
+        if not data.get("ok"):
+            raise BrsxCloudError(data.get("error", "Bilinmeyen hata."))
+
+        return data["reply"]

brsxcloud-0.1.0/brsxcloud.egg-info/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: brsxcloud
+Version: 0.1.0
+Summary: BRSX-Cloud için resmi Python client — chat edilebilir modellere API key ile erişim
+Author: BRSX Labs
+License: MIT
+Project-URL: Homepage, https://cloud.brsxlabs.com
+Project-URL: Documentation, https://help.brsxlabs.com
+Project-URL: Repository, https://brsxlabs.com
+Keywords: brsx,brsx-cloud,ai,chat,api-client
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT 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
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# brsxcloud
+
+[BRSX-Cloud](https://cloud.brsxlabs.com) için resmi Python client. Chat edilebilir olarak paylaşılmış modellere kendi API key'inle, kod içinden erişmeni sağlar.
+
+## Kurulum
+
+```bash
+pip install brsxcloud
+```
+
+## API Key Alma
+
+1. [cloud.brsxlabs.com](https://cloud.brsxlabs.com) adresinde giriş yap.
+2. Sol menüden **Kullanıcı Paneli**'ni aç.
+3. **API Anahtarların** bölümünden **+ Yeni Key** ile bir key oluştur.
+4. Key sadece o an gösterilir, hemen kopyala — bir daha görüntülenmez.
+
+Her key için günlük istek limiti vardır (panelde görebilirsin).
+
+## Kullanım
+
+```python
+from brsxcloud import Client
+
+client = Client("brsxk_...")  # kendi API key'in
+
+reply = client.chat(model_id=1, message="Merhaba, nasılsın?")
+print(reply)
+```
+
+`model_id`'yi, BRSX-Cloud'daki **Modeller** sekmesinde ilgili modelin sayfasından ya da model sahibinin sana verdiği id'den öğrenebilirsin.
+
+## Hata Yönetimi
+
+```python
+from brsxcloud import Client, BrsxCloudError
+
+client = Client("brsxk_...")
+
+try:
+    reply = client.chat(model_id=1, message="Selam")
+except BrsxCloudError as e:
+    print(f"Hata: {e.message} (durum kodu: {e.status_code})")
+```
+
+Olası hatalar: geçersiz/iptal edilmiş API key, günlük kota aşımı, model bulunamadı, model chat için paylaşılmamış, model çalıştırılırken hata.
+
+## Lisans
+
+MIT

brsxcloud-0.1.0/brsxcloud.egg-info/SOURCES.txt

@@ -0,0 +1,7 @@
+README.md
+pyproject.toml
+brsxcloud/__init__.py
+brsxcloud.egg-info/PKG-INFO
+brsxcloud.egg-info/SOURCES.txt
+brsxcloud.egg-info/dependency_links.txt
+brsxcloud.egg-info/top_level.txt

brsxcloud-0.1.0/brsxcloud.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

brsxcloud-0.1.0/brsxcloud.egg-info/top_level.txt

@@ -0,0 +1 @@
+brsxcloud

brsxcloud-0.1.0/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "brsxcloud"
+version = "0.1.0"
+description = "BRSX-Cloud için resmi Python client — chat edilebilir modellere API key ile erişim"
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [
+    { name = "BRSX Labs" }
+]
+keywords = ["brsx", "brsx-cloud", "ai", "chat", "api-client"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+
+[project.urls]
+Homepage = "https://cloud.brsxlabs.com"
+Documentation = "https://help.brsxlabs.com"
+Repository = "https://brsxlabs.com"

brsxcloud-0.1.0/setup.cfg

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