thinhost 0.1.0__tar.gz

thinhost-0.1.0/PKG-INFO

@@ -0,0 +1,50 @@
+Metadata-Version: 2.4
+Name: thinhost
+Version: 0.1.0
+Summary: Thin HTTP hosts for Decelium microsite workflows
+Home-page: https://github.com/Decelium/decelium_simple_host
+Author: Justin Girard
+Author-email: justingirard@decelium.com
+License: MIT
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Requires-Dist: nodejobs>=0.3.0
+Requires-Dist: flask
+Requires-Dist: flask-cors
+Requires-Dist: requests
+Requires-Dist: httpx
+Requires-Dist: psutil
+Requires-Dist: python-dotenv
+Requires-Dist: urllib3
+Requires-Dist: werkzeug
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# thinhost
+
+Thin HTTP hosts used in the Decelium microsite workflow.
+
+## Install
+pip install thinhost
+
+## What's included
+- Simple web server: `decelium_simple_host.simple_web_server`
+- Upload host: `decelium_simple_host.simple_upload_host` (requires `decelium_core_data`)
+- LLM proxy: `decelium_simple_host.llm_base_service` (requires extra deps)
+
+## Run
+python -m decelium_simple_host.simple_web_server
+python -m decelium_simple_host.simple_upload_host
+python -m decelium_simple_host.llm_base_service

thinhost-0.1.0/README.md

@@ -0,0 +1,16 @@
+# thinhost
+
+Thin HTTP hosts used in the Decelium microsite workflow.
+
+## Install
+pip install thinhost
+
+## What's included
+- Simple web server: `decelium_simple_host.simple_web_server`
+- Upload host: `decelium_simple_host.simple_upload_host` (requires `decelium_core_data`)
+- LLM proxy: `decelium_simple_host.llm_base_service` (requires extra deps)
+
+## Run
+python -m decelium_simple_host.simple_web_server
+python -m decelium_simple_host.simple_upload_host
+python -m decelium_simple_host.llm_base_service

thinhost-0.1.0/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"

thinhost-0.1.0/setup.cfg

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

thinhost-0.1.0/setup.py

@@ -0,0 +1,35 @@
+from pathlib import Path
+from setuptools import setup, find_packages
+
+long_description = Path("README.md").read_text(encoding="utf-8")
+
+setup(
+    name="thinhost",
+    version="0.1.0",
+    description="Thin HTTP hosts for Decelium microsite workflows",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    author="Justin Girard",
+    author_email="justingirard@decelium.com",
+    url="https://github.com/Decelium/decelium_simple_host",
+    license="MIT",
+    classifiers=[
+        "Development Status :: 2 - Pre-Alpha",
+        "Intended Audience :: Developers",
+        "License :: OSI Approved :: MIT License",
+        "Programming Language :: Python :: 3",
+    ],
+    packages=find_packages(),
+    install_requires=[
+        "nodejobs>=0.3.0",
+        "flask",
+        "flask-cors",
+        "requests",
+        "httpx",
+        "psutil",
+        "python-dotenv",
+        "urllib3",
+        "werkzeug",
+    ],
+    python_requires=">=3.7",
+)

thinhost-0.1.0/thinhost/llm_base_service.py

@@ -0,0 +1,93 @@
+
+try:
+    from simple_upload_host import UploadService
+except:
+    from .simple_upload_host import UploadService
+
+import os, sys
+import httpx
+from flask import Response, request
+from processing_graph.ProcessingNode import ProcessingNode
+class LLMProxyService(UploadService):
+ 
+    @classmethod
+    def _after_launch_endpoints(cls, app, hostSpec):
+        hostSpec = cls.tHostSpec(hostSpec)     
+        openai_key = hostSpec.get(hostSpec.f_open_ai_key, None)
+        if not openai_key:
+            raise RuntimeError('openai_api_key is not set in hostSpec')
+
+        client = httpx.Client(
+            base_url='https://api.openai.com',
+            headers={'Authorization': f'Bearer {openai_key}'}
+        )
+     
+        def _proxy(path: str):
+            body    = request.get_data()
+            payload = request.get_json(silent=True) or {}
+
+            if payload.get("stream", False):
+                def generate():
+                    with client.stream(
+                        "POST", path,
+                        content=body,
+                        headers={"Content-Type":"application/json"},
+                        timeout=None
+                    ) as resp:
+                        for chunk in resp.iter_bytes():
+                            yield chunk
+                return Response(generate(), content_type="text/event-stream")
+
+            resp = client.post(path, content=body, headers={"Content-Type":"application/json"})
+            return Response(resp.content, status=resp.status_code,
+                            content_type=resp.headers.get("content-type"))
+
+
+
+        def _proxy_models():
+                    resp = client.get('/v1/models')
+                    return Response(
+                        resp.content,
+                        status=resp.status_code,
+                        content_type=resp.headers.get("content-type")
+                    )
+
+        app.add_url_rule(
+            '/v1/models',
+            endpoint='proxy_models',
+            view_func=_proxy_models,
+            methods=['GET']
+        )
+
+        app.add_url_rule(
+            '/v1',
+            endpoint='health',
+            view_func=lambda: Response(
+                '{"status":"ok"}',
+                status=200,
+                content_type='application/json'
+            ),
+            methods=['GET']
+        )
+
+        # register both endpoints
+        app.add_url_rule(
+            '/v1/chat/completions',
+            endpoint='proxy_chat',
+            view_func=lambda: _proxy('/v1/chat/completions'),
+            methods=['POST']
+        )
+        app.add_url_rule(
+            '/v1/completions',
+            endpoint='proxy_completions',
+            view_func=lambda: _proxy('/v1/completions'),
+            methods=['POST']
+        )    
+if __name__ == "__main__":
+    from dotenv import load_dotenv
+    load_dotenv()     
+    LLMProxyService.run_cli()
+# python llm_base_service.py launch [[server=./test_specs/hostSpec.json]] -- For a quick test
+# python llm_base_service.py start "[[server=./test_specs/hostSpec.json]]" -- deploy job to nodejobs
+# open-webui serve UI layer (rests on service)
+# TODO wrap up with retry and uptime monitor

thinhost-0.1.0/thinhost/llm_base_service_test.py

@@ -0,0 +1,264 @@
+#!/usr/bin/env python3
+import unittest
+import os
+import shutil
+import time
+import requests
+from dotenv import load_dotenv
+from llm_base_service import LLMProxyService  # your subclass with proxy support
+from pathlib import Path
+import json
+from typing import Any, Dict
+from decelium_wallet.commands.BaseData import BaseData
+
+from proxy_service_model import ProxyServiceModel
+'''
+some proxy_service_model content:
+---
+
+class ProxyServiceModel(BaseModel):
+    endpoint: str    # e.g. "http://localhost:8003"
+    api_key: str
+    model_id: str
+
+    def generate(self,
+                 messages: List[Dict[str, str]],
+                 **kwargs: Any) -> str:
+        url = f"{self.endpoint}/v1/chat/completions"
+        assert self.endpoint != None
+        assert self.model_id != None
+        assert messages != None
+
+        headers = {
+            "Authorization": f"Bearer {self.api_key}",
+            "Content-Type":  "application/json",
+        }
+        payload = {"model": self.model_id, "messages": messages, **kwargs}
+        print(f"URL OUT : {type(url)}----{url}")
+        r = requests.post(url, json=payload, headers=headers, timeout=60)
+        r.raise_for_status()
+        return r.json()["choices"][0]["message"]["content"]
+
+    def stream(self,
+               messages: List[Dict[str, str]],
+               **kwargs: Any):
+        url = f"{self.endpoint}/v1/chat/completions"
+        headers = {
+            "Authorization": f"Bearer {self.api_key}",
+            "Content-Type":  "application/json",
+        }
+        payload = {"model": self.model_id,
+                   "messages": messages,
+                   "stream": True,
+                   **kwargs}
+        r = requests.post(url, json=payload,
+                          headers=headers,
+                          stream=True,
+                          timeout=None)
+        r.raise_for_status()
+        for line in r.iter_lines():
+            if line.startswith(b"data:"):
+                data = line.removeprefix(b"data:").strip()
+                if data == b"[DONE]":
+                    break
+                yield data.decode()
+
+
+'''
+class LMStudioSchemaEntry(BaseData):
+    type: str
+    default: (Any, None)
+
+class LMStudioConfigSchema(BaseData):
+    endpoint: LMStudioSchemaEntry
+    api_key: LMStudioSchemaEntry
+    model_id: LMStudioSchemaEntry
+    def get_keys(self): # Make sure all other keys are entries as well.
+        req,opt = super().get_keys()
+        req = {"*":LMStudioSchemaEntry}
+        return req,opt 
+
+class LMStudioModel(BaseData):
+    name: str
+    display_name: str
+    entrypoint: str
+    config_schema: LMStudioConfigSchema
+
+class TestLLMProxyService(unittest.TestCase):
+    @staticmethod
+    def get_model_config():
+
+        model = LMStudioModel({
+            LMStudioModel.name:        "lama-service",
+            LMStudioModel.display_name:"LamaService Proxy",
+            LMStudioModel.entrypoint:  "model.py",
+            LMStudioModel.config_schema: LMStudioConfigSchema({
+                LMStudioConfigSchema.endpoint: {
+                    LMStudioSchemaEntry.type:    "string",
+                    LMStudioSchemaEntry.default: "http://localhost:8003"
+                },
+                LMStudioConfigSchema.api_key: {
+                    LMStudioSchemaEntry.type:    "string",
+                    LMStudioSchemaEntry.default: "<<OPENAI_API_KEY>>"
+                },
+                LMStudioConfigSchema.model_id: {
+                    LMStudioSchemaEntry.type:    "string",
+                    LMStudioSchemaEntry.default: "gpt-3.5-turbo"
+                }
+            })
+        })
+        return model
+    
+
+
+
+    def test_register(self):
+
+        model = TestLLMProxyService.get_model_config()
+
+        base_dir = Path.home() / ".lmstudio" / "models" / model[LMStudioModel.name]
+        base_dir.mkdir(parents=True, exist_ok=True)
+
+        model_json = base_dir / "model.json"
+        with model_json.open("w") as f:
+            json.dump(dict(model), f, indent=2)
+
+        # verify registration
+        self.assertTrue(model_json.exists())
+        data = json.loads(model_json.read_text())
+        self.assertEqual(data.get("name"), model[LMStudioModel.name])
+        self.assertEqual(data.get("entrypoint"), model[LMStudioModel.entrypoint])
+        # from proxy_service_model import ProxyServiceModel copy tp model.py
+        src = Path(__file__).parent / "proxy_service_model.py"
+        dst = base_dir / model[LMStudioModel.entrypoint]
+        shutil.copy(src, dst)
+        self.assertTrue(dst.exists())        
+
+
+    def test_chat_completions_via_model(self):
+
+        # set up and start the proxy server
+        hostSpec = {
+            "protocol":     "http",
+            "host":         "127.0.0.1",
+            "port":         "8003",
+            "url":          "/do_upload",
+            "command_uri":  "/cmd",
+            "upload_dir":   "./tmp/upload",
+            "settings_dir": "./tmp/settings",
+            "tokens":       "<<DSH_SERVER_TOKEN_LIST>>",
+            "open_ai_key":  "<<OPENAI_API_KEY>>",
+            "published":    []
+        }
+        hostSpec = LLMProxyService.tHostSpec(hostSpec)
+        shutil.rmtree(hostSpec["upload_dir"], ignore_errors=True)
+        shutil.rmtree(hostSpec["settings_dir"], ignore_errors=True)
+
+        LLMProxyService.run(__command=["stop"], **hostSpec)
+        time.sleep(0.2)
+        LLMProxyService.run(__command=["start"], **hostSpec)
+        time.sleep(0.5)
+
+        # build config for the ProxyServiceModel from our schema
+        model_cfg = TestLLMProxyService.get_model_config()
+        entries = dict(model_cfg.config_schema)
+        print(json.dumps(entries,indent=4))
+        #return
+        sc = LMStudioConfigSchema
+        conf = {
+            sc.endpoint: LMStudioSchemaEntry(entries[sc.endpoint]).default,
+            sc.api_key:  LMStudioSchemaEntry(entries[sc.api_key]).default,
+            sc.model_id: LMStudioSchemaEntry(entries[sc.model_id]).default
+        }
+        assert conf["endpoint"]
+        assert  conf["api_key"]
+        assert conf["model_id"]
+        proxy_model = ProxyServiceModel(**conf)
+
+        # non-streaming check
+        reply = proxy_model.generate([{"role": "user", "content": "Hello, world!"}])
+        self.assertIsInstance(reply, str)
+        self.assertTrue(reply.strip())
+
+        # streaming check
+        stream_iter = proxy_model.stream([{"role": "user", "content": "Hello again!"}])
+        collected = ""
+        for chunk in stream_iter:
+            try:
+                data = json.loads(chunk)
+            except json.JSONDecodeError:
+                continue
+            for choice in data.get("choices", []):
+                text = choice.get("delta", {}).get("content")
+                if text:
+                    collected += text
+
+        self.assertTrue(len(collected.strip()) > 3, f"Stream did not yield enough content ->[{collected}]")
+        print(f"!!! {collected}")
+        with self.assertRaises(StopIteration):
+            next(stream_iter)
+
+        # shut down
+        LLMProxyService.run(__command=["stop"], **hostSpec)
+
+    def test_chat_completions_direct(self):
+        load_dotenv()
+
+        hostSpec = {
+            "protocol":     "http",
+            "host":         "127.0.0.1",
+            "port":         "8003",
+            "url":          "/do_upload",
+            "command_uri":  "/cmd",
+            "upload_dir":   "./tmp/upload",
+            "settings_dir": "./tmp/settings",
+            "tokens":       "<<DSH_SERVER_TOKEN_LIST>>",
+            "open_ai_key": "<<OPENAI_API_KEY>>",
+            "published":    []
+        }
+        hostSpec = LLMProxyService.tHostSpec(hostSpec)
+        # clean before start
+        shutil.rmtree(hostSpec["upload_dir"], ignore_errors=True)
+        shutil.rmtree(hostSpec["settings_dir"], ignore_errors=True)
+
+        # start server
+        LLMProxyService.run(__command=["stop"], **hostSpec)
+        time.sleep(1)
+        LLMProxyService.run(__command=["start"], **hostSpec)
+        time.sleep(0.2)
+        
+        # hit chat completions proxy
+        resp = requests.post(
+            f"http://{hostSpec['host']}:{hostSpec['port']}/v1/chat/completions",
+            json={
+                "model": "gpt-3.5-turbo",
+                "messages": [{"role": "user", "content": "Hello, world!"}]
+            }
+        )
+        print(resp.json())
+        self.assertEqual(resp.status_code, 200)
+        data = resp.json()
+        self.assertIn("choices", data)
+
+        # hit models proxy
+        resp = requests.get(f"http://{hostSpec['host']}:{hostSpec['port']}/v1/models")
+        self.assertEqual(resp.status_code, 200)
+        models = resp.json()
+        self.assertIsInstance(models, dict)
+        self.assertIn("data", models)
+        self.assertIsInstance(models["data"], list)
+
+        # hit health endpoint
+        resp = requests.get(f"http://{hostSpec['host']}:{hostSpec['port']}/v1")
+        self.assertEqual(resp.status_code, 200)
+        self.assertEqual(resp.json(), {"status": "ok"})
+
+
+if __name__ == "__main__":
+    #unittest.main()
+    from dotenv import load_dotenv
+    load_dotenv()         
+    #unittest.main(defaultTest="TestLLMProxyService.test_chat_completions_via_model")
+    unittest.main(defaultTest="TestLLMProxyService.test_chat_completions_direct")
+
+    #unittest.main(defaultTest="TestLLMProxyService.test_register")

thinhost-0.1.0/thinhost/proxy_service_model.py

@@ -0,0 +1,50 @@
+from lmstudio import BaseModel
+import requests
+from typing import List, Dict, Any
+
+class ProxyServiceModel(BaseModel):
+    endpoint: str    # e.g. "http://localhost:8003"
+    api_key: str
+    model_id: str
+
+    def generate(self,
+                 messages: List[Dict[str, str]],
+                 **kwargs: Any) -> str:
+        url = f"{self.endpoint}/v1/chat/completions"
+        assert self.endpoint != None
+        assert self.model_id != None
+        assert messages != None
+
+        headers = {
+            "Authorization": f"Bearer {self.api_key}",
+            "Content-Type":  "application/json",
+        }
+        payload = {"model": self.model_id, "messages": messages, **kwargs}
+        print(f"URL OUT : {type(url)}----{url}")
+        r = requests.post(url, json=payload, headers=headers, timeout=60)
+        r.raise_for_status()
+        return r.json()["choices"][0]["message"]["content"]
+
+    def stream(self,
+               messages: List[Dict[str, str]],
+               **kwargs: Any):
+        url = f"{self.endpoint}/v1/chat/completions"
+        headers = {
+            "Authorization": f"Bearer {self.api_key}",
+            "Content-Type":  "application/json",
+        }
+        payload = {"model": self.model_id,
+                   "messages": messages,
+                   "stream": True,
+                   **kwargs}
+        r = requests.post(url, json=payload,
+                          headers=headers,
+                          stream=True,
+                          timeout=None)
+        r.raise_for_status()
+        for line in r.iter_lines():
+            if line.startswith(b"data:"):
+                data = line.removeprefix(b"data:").strip()
+                if data == b"[DONE]":
+                    break
+                yield data.decode()