player2 0.0.1__py3-none-any.whl

player2/__init__.py

@@ -0,0 +1 @@
+from .core import APIClient

player2/core.py

@@ -0,0 +1,130 @@
+import time
+import threading
+import requests
+from typing import Optional, Dict, Any, List
+
+
+class APIClient:
+    def __init__(self, game_id: str, base_url: Optional[str] = None):
+        self.game_id = game_id
+
+        # Fallback for base_url if not provided
+        if not base_url:
+            self.base_url = "http://127.0.0.1:4315/v1"
+        else:
+            self.base_url = base_url
+
+        # Automatically fetch the p2Key upon initialization
+        self.p2_key = self._login()
+
+        # Start the background health check loop
+        self._start_health_checker()
+
+    def _login(self) -> str:
+        login_url = f"http://localhost:4315/v1/login/web/{self.game_id}"
+
+        try:
+            response = requests.post(login_url, json={})
+            response.raise_for_status()
+            data = response.json()
+            return data["p2Key"]
+        except requests.exceptions.RequestException as e:
+            raise RuntimeError(f"Login failed: {e}")
+
+    def _start_health_checker(self):
+        """Starts a background thread that pings the health endpoint every 60 seconds."""
+
+        def health_loop():
+            health_url = "http://127.0.0.1:4315/v1/health"
+            while True:
+                try:
+                    requests.get(health_url, timeout=5)
+                except requests.exceptions.RequestException:
+                    pass
+                time.sleep(60)
+
+        thread = threading.Thread(target=health_loop, daemon=True)
+        thread.start()
+
+    def chat(self, user: str, system: Optional[str] = None, stream: bool = False) -> str:
+        endpoint = f"{self.base_url}/chat/completions"
+
+        messages: List[Dict[str, str]] = [
+            {"role": "user", "content": user}
+        ]
+
+        if system is not None:
+            messages.insert(0, {"role": "system", "content": system})
+
+        payload = {
+            "messages": messages,
+            "stream": stream
+        }
+
+        headers = {
+            "Authorization": f"Bearer {self.p2_key}"
+        }
+
+        try:
+            response = requests.post(endpoint, json=payload, headers=headers)
+            response.raise_for_status()
+            data = response.json()
+
+            return data["choices"][0]["message"]["content"]
+
+        except requests.exceptions.HTTPError as e:
+            error_body = e.response.text if e.response else "No error body"
+            raise RuntimeError(f"API request failed with status {e.response.status_code}: {error_body}")
+        except requests.exceptions.RequestException as e:
+            raise RuntimeError(f"Network error occurred: {e}")
+        except (KeyError, IndexError) as e:
+            raise RuntimeError(f"Unexpected response format from API: {e}")
+
+    def speak(
+            self,
+            text: str,
+            instructions: Optional[str] = "Speak with a sad tone",
+            voice_gender: str = "female",
+            voice_language: str = "en_US",
+            voice_ids: Optional[List[str]] = None,
+            speed: float = 1.0,
+            audio_format: str = "mp3",
+            play_in_app: bool = True
+    ) -> Dict[str, Any]:
+        """Sends a Text-to-Speech request to the local TTS endpoint."""
+        tts_url = "http://127.0.0.1:4315/v1/tts/speak"
+
+        # Use default voice ID from your curl example if none provided
+        if voice_ids is None:
+            voice_ids = ["01955d76-ed5b-73e0-a88d-cbeb3c5b499d"]
+
+        payload: Dict[str, Any] = {
+            "audio_format": audio_format,
+            "play_in_app": play_in_app,
+            "speed": speed,
+            "text": text,
+            "voice_gender": voice_gender,
+            "voice_ids": voice_ids,
+            "voice_language": voice_language
+        }
+
+        # Add advanced voice instructions if provided
+        if instructions is not None:
+            payload["advanced_voice"] = {
+                "instructions": instructions
+            }
+
+        headers = {
+            "accept": "application/json",
+            "Content-Type": "application/json"
+        }
+
+        try:
+            response = requests.post(tts_url, json=payload, headers=headers)
+            response.raise_for_status()
+            return response.json()
+        except requests.exceptions.HTTPError as e:
+            error_body = e.response.text if e.response else "No error body"
+            raise RuntimeError(f"TTS request failed with status {e.response.status_code}: {error_body}")
+        except requests.exceptions.RequestException as e:
+            raise RuntimeError(f"TTS network error occurred: {e}")

player2-0.0.1.dist-info/METADATA

@@ -0,0 +1,62 @@
+Metadata-Version: 2.4
+Name: player2
+Version: 0.0.1
+Summary: A lightweight client for Player2
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests
+
+# Local API Client
+
+A lightweight Python client designed to easily interact with Player2 Local Endpoints.
+
+## Installation
+
+Install the package via pip:
+
+```bash
+pip install player2
+```
+
+## Usage
+
+### 1. Initialize the Client
+
+When initializing the client, pass your `game_id`. It will automatically handle web login to fetch authorization keys and spin up a background health-check loop.
+
+```python
+from player2 import APIClient
+
+client = APIClient(game_id="your_game_id")  # Get the gameID from the player2 website
+```
+
+### 2. Chat Completions
+
+Send user queries with optional system instructions:
+
+```python
+response = client.chat(
+    user="Hello, how are you doing today?",
+    system="You are a helpful and witty assistant."
+)
+
+print(response)
+
+```
+
+### 3. Text-to-Speech (TTS)
+
+Trigger speech generation locally:
+
+```python
+tts_response = client.speak(
+    text="Hello, how are you doing today?",
+    instructions="Speak with a cheerful tone",
+    speed=1.0
+)
+
+print(tts_response)
+```

player2-0.0.1.dist-info/RECORD

@@ -0,0 +1,6 @@
+player2/__init__.py,sha256=PsI5TL5RCdziUikX_zfngmRAE2GRX3ljIirRtjfmJmg,27
+player2/core.py,sha256=CHDrKHaFH4LqsXkJTZDUqaJa0SBZFKn9Y5PZd1-dUF0,4547
+player2-0.0.1.dist-info/METADATA,sha256=DvoMgHTiFojpZjBWUbB7tL879QkNSnJLqjHhojP6woQ,1319
+player2-0.0.1.dist-info/WHEEL,sha256=a-udL2m4V_6Yn8b-uKzWb12RjRxwwMo6ohYFM24tpaY,91
+player2-0.0.1.dist-info/top_level.txt,sha256=LykiWt7T8bwUYs9MFcsnmZZVlXTPqfVJbkzk-rtW9d4,8
+player2-0.0.1.dist-info/RECORD,,

player2-0.0.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

player2-0.0.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+player2