zephyrcode 1.0.0__py3-none-any.whl

zephyrcode/__init__.py

@@ -0,0 +1,189 @@
+"""
+ZephyrCode Python SDK
+=====================
+The official Python SDK for the ZephyrCode AI coding agent.
+
+Install:
+    pip install zephyrcode
+
+Quick start:
+    from zephyrcode import ZephyrCode
+
+    client = ZephyrCode(api_key="zeph_your_api_key_here")
+
+    response = client.chat.create(
+        messages=[{"role": "user", "content": "Build a React counter"}],
+        model="z-code-ultra",
+        mode="code",
+    )
+    print(response.content)
+
+Author: ZephyrCode Labs
+License: MIT
+"""
+
+import json
+import requests
+from typing import List, Dict, Optional, Any
+
+__version__ = "1.0.0"
+__author__ = "ZephyrCode Labs"
+__email__ = "support@zephyrcode.ai"
+
+BASE_URL = "https://zephyrcode.space-z.ai"
+
+
+class ZephyrCodeError(Exception):
+    """Base exception for ZephyrCode SDK errors."""
+    pass
+
+
+class ZephyrCode:
+    """
+    ZephyrCode AI coding agent client.
+
+    Args:
+        api_key: Your ZephyrCode API key (starts with 'zeph_').
+        base_url: Override the base URL (defaults to https://zephyrcode.space-z.ai).
+    """
+
+    def __init__(self, api_key: str, base_url: str = BASE_URL):
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self.chat = Chat(self)
+
+    def _request(self, method: str, path: str, data: Optional[Dict] = None) -> Dict:
+        url = f"{self.base_url}{path}"
+        headers = {
+            "Content-Type": "application/json",
+            "Authorization": f"Bearer {self.api_key}",
+        }
+        resp = requests.request(method, url, headers=headers, json=data, timeout=120)
+
+        if resp.status_code == 401:
+            raise ZephyrCodeError("Invalid API key. Check your key at https://zephyrcode.space-z.ai/apikey")
+        if resp.status_code == 429:
+            raise ZephyrCodeError("Rate limit exceeded. Upgrade your plan for higher limits.")
+        if resp.status_code >= 500:
+            raise ZephyrCodeError(f"Server error: {resp.status_code}")
+
+        return resp.json()
+
+    def tts(self, text: str, voice: str = "adam", speed: float = 1.0) -> bytes:
+        """
+        Generate speech from text using ZephyrCode's TTS engine.
+
+        Args:
+            text: The text to convert to speech (max 4000 chars).
+            voice: Voice ID (e.g. 'adam', 'rachel', 'hindi-priya').
+            speed: Speech speed (0.5 - 2.0).
+
+        Returns:
+            WAV audio bytes.
+        """
+        url = f"{self.base_url}/api/tts"
+        headers = {
+            "Content-Type": "application/json",
+            "Authorization": f"Bearer {self.api_key}",
+        }
+        resp = requests.post(url, headers=headers, json={
+            "text": text, "voice": voice, "speed": speed
+        }, timeout=60)
+
+        if resp.status_code != 200:
+            raise ZephyrCodeError(f"TTS failed: {resp.status_code}")
+
+        return resp.content
+
+
+class Chat:
+    """Chat / agent endpoint accessor."""
+
+    def __init__(self, client: ZephyrCode):
+        self.client = client
+
+    def create(
+        self,
+        messages: List[Dict[str, str]],
+        model: str = "z-code-ultra",
+        mode: str = "code",
+        thinking: bool = True,
+    ) -> "ChatResponse":
+        """
+        Send a chat request to the ZephyrCode AI agent.
+
+        Args:
+            messages: List of message dicts with 'role' and 'content'.
+            model: Model ID ('z-code-ultra', 'z-code-pro', 'z-code-edge').
+            mode: Agent mode ('code', 'agentic', 'appbuilder', 'websitebuilder',
+                  'teamwork', 'architect', 'debug', 'review', 'explain').
+            thinking: Enable extended thinking/reasoning.
+
+        Returns:
+            ChatResponse object with .content, .reasoning, .tool_calls, .plan.
+        """
+        data = self.client._request("POST", "/api/agent", {
+            "messages": messages,
+            "model": model,
+            "mode": mode,
+            "thinking": thinking,
+        })
+        return ChatResponse(data)
+
+
+class ChatResponse:
+    """
+    Response from the ZephyrCode AI agent.
+
+    Attributes:
+        content: The main text response (markdown).
+        reasoning: List of reasoning steps (if thinking was enabled).
+        tool_calls: List of tool calls the agent made.
+        plan: The execution plan (if generated).
+        model: The model used.
+        mode: The agent mode used.
+        fallback_used: Whether a fallback was used (LLM was unavailable).
+    """
+
+    def __init__(self, data: Dict[str, Any]):
+        self.content: str = data.get("content", "")
+        self.reasoning: List = data.get("reasoning", [])
+        self.tool_calls: List = data.get("tool_calls", [])
+        self.plan: Optional[Dict] = data.get("plan")
+        self.model: str = data.get("model", "")
+        self.mode: str = data.get("mode", "")
+        self.fallback_used: bool = data.get("fallback_used", False)
+
+    def __str__(self) -> str:
+        return self.content
+
+    def __repr__(self) -> str:
+        return f"ChatResponse(model='{self.model}', mode='{self.mode}', content_length={len(self.content)})"
+
+
+# Convenience function for quick one-shot calls
+def generate(
+    prompt: str,
+    api_key: str,
+    model: str = "z-code-ultra",
+    mode: str = "code",
+) -> str:
+    """
+    Quick one-shot code generation.
+
+    Args:
+        prompt: Your coding request.
+        api_key: Your ZephyrCode API key.
+        model: Model to use.
+        mode: Agent mode.
+
+    Returns:
+        The generated text content.
+    """
+    client = ZephyrCode(api_key=api_key)
+    response = client.chat.create(
+        messages=[{"role": "user", "content": prompt}],
+        model=model,
+        mode=mode,
+    )
+    return response.content

zephyrcode/__version__.py

@@ -0,0 +1,6 @@
+"""ZephyrCode Python SDK — Official AI coding agent SDK."""
+
+__version__ = "1.0.0"
+__author__ = "ZephyrCode Labs"
+__email__ = "support@zephyrcode.ai"
+__all__ = ["ZephyrCode", "ZephyrCodeError", "ChatResponse", "generate"]

zephyrcode-1.0.0.dist-info/METADATA

@@ -0,0 +1,94 @@
+Metadata-Version: 2.4
+Name: zephyrcode
+Version: 1.0.0
+Summary: Official ZephyrCode AI coding agent SDK — generate code, use TTS, and build with AI.
+Author-email: ZephyrCode Labs <support@zephyrcode.ai>
+License: MIT
+Project-URL: Homepage, https://zephyrcode.space-z.ai
+Project-URL: Documentation, https://zephyrcode.space-z.ai/apikey
+Project-URL: Repository, https://github.com/zephyrcode/zephyrcode-python
+Project-URL: Bug Tracker, https://github.com/zephyrcode/zephyrcode-python/issues
+Keywords: AI,coding agent,code generator,AI code,TTS,text-to-speech,voice cloning,API,SDK,zephyrcode,z-code,GitHub Copilot alternative,Cursor alternative
+Classifier: Development Status :: 4 - Beta
+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.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
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28.0
+Dynamic: license-file
+
+# ZephyrCode Python SDK
+
+The official Python SDK for the ZephyrCode AI coding agent.
+
+## Install
+
+```bash
+pip install zephyrcode
+```
+
+## Quick Start
+
+```python
+from zephyrcode import ZephyrCode
+
+client = ZephyrCode(api_key="zeph_your_api_key_here")
+
+response = client.chat.create(
+    messages=[
+        {"role": "user", "content": "Build a React counter component"}
+    ],
+    model="z-code-ultra",
+    mode="code",
+)
+
+print(response.content)
+```
+
+## Text-to-Speech
+
+```python
+client = ZephyrCode(api_key="zeph_your_api_key_here")
+
+audio_bytes = client.tts(
+    text="Hello world!",
+    voice="adam",
+    speed=1.0,
+)
+
+with open("output.wav", "wb") as f:
+    f.write(audio_bytes)
+```
+
+## Agent Modes
+
+- `code` — Write, edit, and refactor production code
+- `agentic` — Autonomous multi-step engineering
+- `appbuilder` — Build full-stack apps from a single prompt
+- `websitebuilder` — Generate complete websites
+- `teamwork` — Collaborate with team members
+- `architect` — Design systems and evaluate tradeoffs
+- `debug` — Root-cause failures and propose fixes
+- `review` — Review diffs for style, security, and performance
+- `explain` — Explain code, concepts, and tradeoffs
+
+## Models
+
+- `z-code-ultra` — Frontier model (2M context)
+- `z-code-pro` — Balanced model (256K context)
+- `z-code-edge` — Lightweight on-device model (32K context)
+
+## License
+
+MIT

zephyrcode-1.0.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+zephyrcode/__init__.py,sha256=d8Fyc1C4Cd42Ihq_3-JnzcbKHe1W2DBzq-kSwnAGfbI,5631
+zephyrcode/__version__.py,sha256=yPxwvdzKFtYoez2qJtBxe75E_1cVGwAN6XydDTkTzbk,224
+zephyrcode-1.0.0.dist-info/licenses/LICENSE,sha256=bX7yFZS6TmYf0BIpwvrPB8huZ_FNKcs0DlJY8woUABc,1072
+zephyrcode-1.0.0.dist-info/METADATA,sha256=EAIslj47hYXX6ul78D2SZi0hOlGOrqbu90N-2b2jO-I,2836
+zephyrcode-1.0.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+zephyrcode-1.0.0.dist-info/top_level.txt,sha256=wi_kd0ow8EQgbQ9xawzgjCJsBDTPbTktrvnyYSaDpco,11
+zephyrcode-1.0.0.dist-info/RECORD,,

zephyrcode-1.0.0.dist-info/WHEEL

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

zephyrcode-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ZephyrCode Labs
+
+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.

zephyrcode-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+zephyrcode