frutebox 0.0.1__tar.gz

frutebox-0.0.1/.gitignore

@@ -0,0 +1,4 @@
+node_modules/
+__pycache__/
+dist/
+*.egg-info/

frutebox-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Frutebox
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

frutebox-0.0.1/PKG-INFO

@@ -0,0 +1,65 @@
+Metadata-Version: 2.5
+Name: frutebox
+Version: 0.0.1
+Summary: Official Frutebox SDK for Python — call the Frutebox network. No third-party AI SDK required.
+Project-URL: Homepage, https://frutebox.com
+Project-URL: Documentation, https://frutebox.com/docs
+Project-URL: Changelog, https://frutebox.com/docs
+Author: Frutebox
+License: MIT
+License-File: LICENSE
+Keywords: ai,assistant,frutebox,llm,sdk
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Requires-Dist: requests>=2.25
+Description-Content-Type: text/markdown
+
+# frutebox
+
+The official [Frutebox](https://frutebox.com) SDK for Python — call the Frutebox network with no
+third-party AI library.
+
+```bash
+pip install frutebox
+```
+
+```python
+from frutebox import Frutebox
+
+frutebox = Frutebox(api_key="sk_live_...")  # or set FRUTEBOX_API_KEY
+res = frutebox.chat.completions.create(
+    messages=[{"role": "user", "content": "Draft a friendly reminder email."}],
+)
+print(res["choices"][0]["message"]["content"])
+```
+
+Supports chat + streaming, tool calling, images, videos, audio, moderations and models.
+HTTPS is enforced, so your key is never sent in plaintext.
+
+- Get an API key: <https://frutebox.com/app/keys>
+- Documentation: <https://frutebox.com/docs>
+
+`FRUTEBOX_API_KEY` is read from the environment when no `api_key` is passed. The older
+`STEVAI_API_KEY` is still accepted so existing environments keep working; `FRUTEBOX_API_KEY` wins
+when both are set.
+
+## Status
+
+**0.0.1 is an early release.** The client is hand-written, and a fully typed client generated from
+the published API specification is planned. The surface may change before 1.0.
+
+This release calls the OpenAI-shaped compatibility endpoint (`/api/v1/chat/completions`), which is
+being phased out in favour of the native Frutebox API. Your code here is not affected — the move
+happens behind this client — but if you are calling the HTTP API directly, prefer the native
+endpoint. See <https://frutebox.com/docs>.
+
+## Licence
+
+MIT — see [LICENSE](LICENSE).

frutebox-0.0.1/README.md

@@ -0,0 +1,42 @@
+# frutebox
+
+The official [Frutebox](https://frutebox.com) SDK for Python — call the Frutebox network with no
+third-party AI library.
+
+```bash
+pip install frutebox
+```
+
+```python
+from frutebox import Frutebox
+
+frutebox = Frutebox(api_key="sk_live_...")  # or set FRUTEBOX_API_KEY
+res = frutebox.chat.completions.create(
+    messages=[{"role": "user", "content": "Draft a friendly reminder email."}],
+)
+print(res["choices"][0]["message"]["content"])
+```
+
+Supports chat + streaming, tool calling, images, videos, audio, moderations and models.
+HTTPS is enforced, so your key is never sent in plaintext.
+
+- Get an API key: <https://frutebox.com/app/keys>
+- Documentation: <https://frutebox.com/docs>
+
+`FRUTEBOX_API_KEY` is read from the environment when no `api_key` is passed. The older
+`STEVAI_API_KEY` is still accepted so existing environments keep working; `FRUTEBOX_API_KEY` wins
+when both are set.
+
+## Status
+
+**0.0.1 is an early release.** The client is hand-written, and a fully typed client generated from
+the published API specification is planned. The surface may change before 1.0.
+
+This release calls the OpenAI-shaped compatibility endpoint (`/api/v1/chat/completions`), which is
+being phased out in favour of the native Frutebox API. Your code here is not affected — the move
+happens behind this client — but if you are calling the HTTP API directly, prefer the native
+endpoint. See <https://frutebox.com/docs>.
+
+## Licence
+
+MIT — see [LICENSE](LICENSE).

frutebox-0.0.1/pyproject.toml

@@ -0,0 +1,35 @@
+[project]
+name = "frutebox"
+version = "0.0.1"
+description = "Official Frutebox SDK for Python — call the Frutebox network. No third-party AI SDK required."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "MIT" }
+authors = [{ name = "Frutebox" }]
+keywords = ["frutebox", "ai", "llm", "assistant", "sdk"]
+dependencies = ["requests>=2.25"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+  "Topic :: Scientific/Engineering :: Artificial Intelligence",
+]
+
+[project.urls]
+Homepage = "https://frutebox.com"
+Documentation = "https://frutebox.com/docs"
+Changelog = "https://frutebox.com/docs"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/frutebox"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/frutebox", "README.md", "LICENSE", "pyproject.toml"]

frutebox-0.0.1/src/frutebox/__init__.py

@@ -0,0 +1,223 @@
+"""Official Frutebox SDK for Python.
+
+A small, familiar client for the Frutebox network's API — no third-party AI SDK
+required. Every answer comes from the real Frutebox network.
+
+    from frutebox import Frutebox
+
+    frutebox = Frutebox(api_key="sk_live_...")
+    res = frutebox.chat.completions.create(
+        messages=[{"role": "user", "content": "Draft a friendly reminder email."}],
+    )
+    print(res["choices"][0]["message"]["content"])
+"""
+from __future__ import annotations
+
+import json
+import os
+from typing import Any, Dict, Iterator, List, Optional
+
+import requests
+
+__all__ = ["Frutebox", "FruteboxError"]
+__version__ = "0.0.1"
+
+
+class FruteboxError(Exception):
+    def __init__(self, message: str, status: int = 0, code: Optional[str] = None):
+        super().__init__(message)
+        self.status = status
+        self.code = code
+
+
+class Frutebox:
+    def __init__(self, api_key: Optional[str] = None, base_url: str = "https://frutebox.com", timeout: float = 60.0):
+        # ACCEPT BOTH, never drop the old one: this is a PUBLISHED SDK contract and the name is
+        # in users' own environments and CI. New spelling wins when both are set.
+        api_key = api_key or os.environ.get("FRUTEBOX_API_KEY") or os.environ.get("STEVAI_API_KEY")
+        if not api_key:
+            raise FruteboxError("A Frutebox API key is required.", 0, "missing_api_key")
+        base_url = base_url.rstrip("/")
+        # Enforce HTTPS so the key is never sent in plaintext (localhost exempt for dev).
+        is_local = base_url.startswith("http://localhost") or base_url.startswith("http://127.0.0.1")
+        if not base_url.startswith("https://") and not is_local:
+            raise FruteboxError("base_url must use https:// (refusing to send your key in plaintext).", 0, "insecure_base_url")
+        self._api_key = api_key
+        self.base_url = base_url
+        self._timeout = timeout
+        self.chat = _Chat(self)
+        self.images = _Images(self)
+        self.videos = _Videos(self)
+        self.audio = _Audio(self)
+        self.moderations = _Moderations(self)
+        self.models = _Models(self)
+
+    # --- transport -------------------------------------------------------
+    def _post(self, path: str, body: Dict[str, Any], stream: bool = False) -> requests.Response:
+        res = requests.post(
+            f"{self.base_url}{path}",
+            headers={"content-type": "application/json", "authorization": f"Bearer {self._api_key}"},
+            data=json.dumps(body),
+            stream=stream,
+            timeout=self._timeout,
+        )
+        if not res.ok:
+            raise self._error(res)
+        return res
+
+    @staticmethod
+    def _error(res: requests.Response) -> FruteboxError:
+        message = f"Frutebox request failed ({res.status_code})."
+        code = None
+        try:
+            body = res.json()
+            err = body.get("error")
+            if isinstance(err, str):
+                message = err
+            elif isinstance(err, dict):
+                message = err.get("message", message)
+                code = err.get("code")
+        except Exception:
+            pass
+        return FruteboxError(message, res.status_code, code)
+
+
+class _Chat:
+    def __init__(self, client: "Frutebox"):
+        self.completions = _Completions(client)
+
+
+class _Completions:
+    def __init__(self, client: "Frutebox"):
+        self._c = client
+
+    def create(
+        self,
+        messages: List[Dict[str, Any]],
+        model: Optional[str] = None,
+        stream: bool = False,
+        region: Optional[str] = None,
+        temperature: Optional[float] = None,
+        max_tokens: Optional[int] = None,
+        top_p: Optional[float] = None,
+        stop: Optional[Any] = None,
+        tools: Optional[List[Dict[str, Any]]] = None,
+        tool_choice: Optional[Any] = None,
+        response_format: Optional[Dict[str, Any]] = None,
+        seed: Optional[int] = None,
+        **extra: Any,
+    ) -> Any:
+        body: Dict[str, Any] = {"messages": messages, "stream": stream, **extra}
+        for key, val in (
+            ("model", model), ("region", region), ("temperature", temperature),
+            ("max_tokens", max_tokens), ("top_p", top_p), ("stop", stop),
+            ("tools", tools), ("tool_choice", tool_choice),
+            ("response_format", response_format), ("seed", seed),
+        ):
+            if val is not None:
+                body[key] = val
+        res = self._c._post("/api/v1/chat/completions", body, stream=stream)
+        if stream:
+            return self._iter(res)
+        return res.json()
+
+    @staticmethod
+    def _iter(res: requests.Response) -> Iterator[Dict[str, Any]]:
+        for line in res.iter_lines(decode_unicode=True):
+            if not line or not line.startswith("data:"):
+                continue
+            data = line[5:].strip()
+            if data == "[DONE]":
+                return
+            try:
+                yield json.loads(data)
+            except Exception:
+                continue
+
+
+class _Images:
+    def __init__(self, client: "Frutebox"):
+        self._c = client
+
+    def generate(self, prompt: str, size: Optional[str] = None, region: Optional[str] = None) -> Dict[str, Any]:
+        body: Dict[str, Any] = {"prompt": prompt}
+        if size:
+            body["size"] = size
+        if region:
+            body["region"] = region
+        return self._c._post("/api/v1/images/generations", body).json()
+
+
+class _Videos:
+    def __init__(self, client: "Frutebox"):
+        self._c = client
+
+    def generate(self, prompt: str, seconds: Optional[int] = None, region: Optional[str] = None) -> Dict[str, Any]:
+        body: Dict[str, Any] = {"prompt": prompt}
+        if seconds:
+            body["seconds"] = seconds
+        if region:
+            body["region"] = region
+        return self._c._post("/api/v1/videos/generations", body).json()
+
+
+class _Audio:
+    def __init__(self, client: "Frutebox"):
+        self._c = client
+        self.transcriptions = _Transcriptions(client)
+
+    def speech(self, input: str, voice: Optional[str] = None, format: Optional[str] = None) -> Dict[str, Any]:
+        body: Dict[str, Any] = {"input": input}
+        if voice:
+            body["voice"] = voice
+        if format:
+            body["format"] = format
+        return self._c._post("/api/v1/audio/speech", body).json()
+
+
+class _Transcriptions:
+    def __init__(self, client: "Frutebox"):
+        self._c = client
+
+    def create(self, file: Any, model: Optional[str] = None, language: Optional[str] = None) -> Dict[str, Any]:
+        data = {k: v for k, v in (("model", model), ("language", language)) if v is not None}
+        res = requests.post(
+            f"{self._c.base_url}/api/v1/audio/transcriptions",
+            headers={"authorization": f"Bearer {self._c._api_key}"},
+            files={"file": file},
+            data=data,
+        )
+        if not res.ok:
+            raise Frutebox._error(res)
+        return res.json()
+
+
+class _Moderations:
+    def __init__(self, client: "Frutebox"):
+        self._c = client
+
+    def create(self, input: Any) -> Dict[str, Any]:
+        return self._c._post("/api/v1/moderations", {"input": input}).json()
+
+
+class _Models:
+    def __init__(self, client: "Frutebox"):
+        self._c = client
+
+    def list(self) -> Dict[str, Any]:
+        res = requests.get(
+            f"{self._c.base_url}/api/v1/models",
+            headers={"authorization": f"Bearer {self._c._api_key}"},
+        )
+        if not res.ok:
+            raise Frutebox._error(res)
+        return res.json()
+
+    def retrieve(self, model_id: str) -> Dict[str, Any]:
+        res = requests.get(
+            f"{self._c.base_url}/api/v1/models/{model_id}",
+            headers={"authorization": f"Bearer {self._c._api_key}"},
+        )
+        if not res.ok:
+            raise Frutebox._error(res)
+        return res.json()