claude2api-client 0.1.0__tar.gz

claude2api_client-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 claude2api contributors
+
+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.

claude2api_client-0.1.0/PKG-INFO

@@ -0,0 +1,147 @@
+Metadata-Version: 2.4
+Name: claude2api-client
+Version: 0.1.0
+Summary: Python client for claude2Api bridge service
+Author: claude2api contributors
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/anthropics/claude2api
+Project-URL: Repository, https://github.com/anthropics/claude2api
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+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 :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28.0
+Requires-Dist: sseclient-py>=1.8.0
+Dynamic: license-file
+
+# claude2api-client
+
+Python client for the [claude2Api](https://github.com/anthropics/claude2api) bridge service — call Claude Code's full capabilities (file I/O, Bash, multi-turn conversations) over HTTP from any Python project.
+
+## Prerequisites
+
+A running **claude2Api** Node.js bridge service. See the [main repo](https://github.com/anthropics/claude2api) for setup instructions.
+
+## Installation
+
+```bash
+pip install claude2api-client
+```
+
+## Quick Start
+
+```python
+from claude2api_client import Claude2Api
+
+api = Claude2Api("http://localhost:3456")
+
+# Single turn
+r = api.chat("Explain Python GIL in one sentence")
+print(r.result)
+
+# Multi-turn conversation
+r2 = api.chat("How about JavaScript?", session_id=r.session_id)
+print(r2.result)
+```
+
+## Streaming
+
+```python
+def on_stream(data):
+    if isinstance(data.get("content"), list):
+        for block in data["content"]:
+            if isinstance(block, dict) and block.get("type") == "text":
+                print(block["text"], end="", flush=True)
+
+r = api.chat("Write a haiku", on_stream=on_stream)
+```
+
+## API Reference
+
+### `Claude2Api(base_url, timeout)`
+
+| Param | Default | Description |
+|-------|---------|-------------|
+| `base_url` | `http://localhost:3456` | Bridge service URL |
+| `timeout` | `300` | Request timeout in seconds |
+
+### `chat(prompt, **kwargs) -> ChatResult`
+
+| Param | Type | Description |
+|-------|------|-------------|
+| `prompt` | `str` | Message to send (required) |
+| `session_id` | `str` | Resume an existing session |
+| `cwd` | `str` | Working directory for file operations |
+| `model` | `str` | Model ID, e.g. `"claude-sonnet-4-6"` |
+| `allowed_tools` | `list` | e.g. `["Read", "Edit", "Bash"]` |
+| `max_turns` | `int` | Max agent turns |
+| `system_prompt` | `str` | Custom system prompt |
+| `on_stream` | `callable` | Callback for intermediate SSE events |
+
+### `ChatResult`
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `session_id` | `str \| None` | Session identifier |
+| `result` | `str \| None` | Final response text |
+| `cost` | `float \| None` | Token cost |
+| `duration` | `float \| None` | Execution time |
+| `is_error` | `bool` | Whether an error occurred |
+| `error` | `str \| None` | Error message |
+
+### Utility methods
+
+- `health() -> dict` — Health check
+- `sessions() -> list` — List active sessions
+- `abort(session_id) -> dict` — Abort a running session
+
+## Publishing to PyPI
+
+```bash
+# Build
+cd python
+python -m build
+
+# Upload to PyPI
+twine upload dist/*
+# username: __token__
+# password: your PyPI API token (https://pypi.org/manage/account/token/)
+
+# Or test on TestPyPI first
+twine upload --repository testpypi dist/*
+pip install --index-url https://test.pypi.org/simple/ claude2api
+```
+
+To skip entering credentials every time, create `~/.pypirc`:
+
+```ini
+[distutils]
+index-servers =
+    pypi
+    testpypi
+
+[pypi]
+username = __token__
+password = pypi-xxxxxxxxxxxxxxxx
+
+[testpypi]
+repository = https://test.pypi.org/legacy/
+username = __token__
+password = pypi-xxxxxxxxxxxxxxxx
+```
+
+To release a new version, update `version` in both `pyproject.toml` and `claude2api_client/__init__.py`, then rebuild and upload.
+
+## License
+
+MIT

claude2api_client-0.1.0/README.md

@@ -0,0 +1,121 @@
+# claude2api-client
+
+Python client for the [claude2Api](https://github.com/anthropics/claude2api) bridge service — call Claude Code's full capabilities (file I/O, Bash, multi-turn conversations) over HTTP from any Python project.
+
+## Prerequisites
+
+A running **claude2Api** Node.js bridge service. See the [main repo](https://github.com/anthropics/claude2api) for setup instructions.
+
+## Installation
+
+```bash
+pip install claude2api-client
+```
+
+## Quick Start
+
+```python
+from claude2api_client import Claude2Api
+
+api = Claude2Api("http://localhost:3456")
+
+# Single turn
+r = api.chat("Explain Python GIL in one sentence")
+print(r.result)
+
+# Multi-turn conversation
+r2 = api.chat("How about JavaScript?", session_id=r.session_id)
+print(r2.result)
+```
+
+## Streaming
+
+```python
+def on_stream(data):
+    if isinstance(data.get("content"), list):
+        for block in data["content"]:
+            if isinstance(block, dict) and block.get("type") == "text":
+                print(block["text"], end="", flush=True)
+
+r = api.chat("Write a haiku", on_stream=on_stream)
+```
+
+## API Reference
+
+### `Claude2Api(base_url, timeout)`
+
+| Param | Default | Description |
+|-------|---------|-------------|
+| `base_url` | `http://localhost:3456` | Bridge service URL |
+| `timeout` | `300` | Request timeout in seconds |
+
+### `chat(prompt, **kwargs) -> ChatResult`
+
+| Param | Type | Description |
+|-------|------|-------------|
+| `prompt` | `str` | Message to send (required) |
+| `session_id` | `str` | Resume an existing session |
+| `cwd` | `str` | Working directory for file operations |
+| `model` | `str` | Model ID, e.g. `"claude-sonnet-4-6"` |
+| `allowed_tools` | `list` | e.g. `["Read", "Edit", "Bash"]` |
+| `max_turns` | `int` | Max agent turns |
+| `system_prompt` | `str` | Custom system prompt |
+| `on_stream` | `callable` | Callback for intermediate SSE events |
+
+### `ChatResult`
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `session_id` | `str \| None` | Session identifier |
+| `result` | `str \| None` | Final response text |
+| `cost` | `float \| None` | Token cost |
+| `duration` | `float \| None` | Execution time |
+| `is_error` | `bool` | Whether an error occurred |
+| `error` | `str \| None` | Error message |
+
+### Utility methods
+
+- `health() -> dict` — Health check
+- `sessions() -> list` — List active sessions
+- `abort(session_id) -> dict` — Abort a running session
+
+## Publishing to PyPI
+
+```bash
+# Build
+cd python
+python -m build
+
+# Upload to PyPI
+twine upload dist/*
+# username: __token__
+# password: your PyPI API token (https://pypi.org/manage/account/token/)
+
+# Or test on TestPyPI first
+twine upload --repository testpypi dist/*
+pip install --index-url https://test.pypi.org/simple/ claude2api
+```
+
+To skip entering credentials every time, create `~/.pypirc`:
+
+```ini
+[distutils]
+index-servers =
+    pypi
+    testpypi
+
+[pypi]
+username = __token__
+password = pypi-xxxxxxxxxxxxxxxx
+
+[testpypi]
+repository = https://test.pypi.org/legacy/
+username = __token__
+password = pypi-xxxxxxxxxxxxxxxx
+```
+
+To release a new version, update `version` in both `pyproject.toml` and `claude2api_client/__init__.py`, then rebuild and upload.
+
+## License
+
+MIT

claude2api_client-0.1.0/claude2api_client/__init__.py

@@ -0,0 +1,6 @@
+"""claude2api-client — Python client for claude2Api bridge service"""
+
+from .client import Claude2Api, ChatResult
+
+__version__ = "0.1.0"
+__all__ = ["Claude2Api", "ChatResult"]

claude2api_client-0.1.0/claude2api_client/client.py

@@ -0,0 +1,121 @@
+"""Claude2Api Python Client"""
+
+import json
+from dataclasses import dataclass
+from typing import Optional, Callable
+
+import requests
+import sseclient
+
+
+@dataclass
+class ChatResult:
+    session_id: Optional[str] = None
+    result: Optional[str] = None
+    cost: Optional[float] = None
+    duration: Optional[float] = None
+    is_error: bool = False
+    error: Optional[str] = None
+
+
+class Claude2Api:
+    """Python client for claude2Api bridge service.
+
+    Usage:
+        api = Claude2Api("http://localhost:3456")
+        r = api.chat("你好")
+        print(r.result)
+
+        # 多轮对话
+        r2 = api.chat("继续", session_id=r.session_id)
+
+        # 交互式（Claude 提问后回复）
+        r3 = api.chat("用 JWT", session_id=r2.session_id)
+    """
+
+    def __init__(self, base_url: str = "http://localhost:3456", timeout: int = 300):
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+
+    def health(self) -> dict:
+        return requests.get(f"{self.base_url}/health", timeout=5).json()
+
+    def sessions(self) -> list:
+        return requests.get(f"{self.base_url}/api/sessions", timeout=5).json()
+
+    def abort(self, session_id: str) -> dict:
+        return requests.post(
+            f"{self.base_url}/api/abort/{session_id}", timeout=5
+        ).json()
+
+    def chat(
+        self,
+        prompt: str,
+        session_id: Optional[str] = None,
+        cwd: Optional[str] = None,
+        model: Optional[str] = None,
+        allowed_tools: Optional[list] = None,
+        max_turns: Optional[int] = None,
+        system_prompt: Optional[str] = None,
+        on_stream: Optional[Callable[[dict], None]] = None,
+    ) -> ChatResult:
+        """Send a message and stream the response.
+
+        Args:
+            prompt: The message to send.
+            session_id: Resume an existing session (multi-turn).
+            cwd: Working directory for file operations.
+            model: Model ID (e.g. "claude-sonnet-4-6").
+            allowed_tools: List of tools (e.g. ["Read", "Edit", "Bash"]).
+            max_turns: Max agent turns.
+            system_prompt: Custom system prompt.
+            on_stream: Callback for intermediate stream events.
+
+        Returns:
+            ChatResult with session_id, result, cost, etc.
+        """
+        url = (
+            f"{self.base_url}/api/chat/{session_id}"
+            if session_id
+            else f"{self.base_url}/api/chat"
+        )
+        payload = {"prompt": prompt}
+        if cwd:
+            payload["cwd"] = cwd
+        if model:
+            payload["model"] = model
+        if allowed_tools:
+            payload["allowedTools"] = allowed_tools
+        if max_turns:
+            payload["maxTurns"] = max_turns
+        if system_prompt:
+            payload["systemPrompt"] = system_prompt
+
+        resp = requests.post(url, json=payload, stream=True, timeout=self.timeout)
+        if resp.status_code != 200:
+            return ChatResult(
+                session_id=session_id,
+                is_error=True,
+                error=resp.text,
+            )
+
+        client = sseclient.SSEClient(resp)
+        cr = ChatResult(session_id=session_id)
+
+        for event in client.events():
+            data = json.loads(event.data)
+            if event.event == "session":
+                cr.session_id = data["sessionId"]
+            elif event.event == "stream":
+                if on_stream:
+                    on_stream(data)
+            elif event.event == "result":
+                cr.result = data.get("result")
+                cr.cost = data.get("cost")
+                cr.duration = data.get("duration")
+                cr.is_error = data.get("isError", False)
+            elif event.event == "error":
+                cr.is_error = True
+                cr.error = data.get("message")
+
+        return cr

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

@@ -0,0 +1,147 @@
+Metadata-Version: 2.4
+Name: claude2api-client
+Version: 0.1.0
+Summary: Python client for claude2Api bridge service
+Author: claude2api contributors
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/anthropics/claude2api
+Project-URL: Repository, https://github.com/anthropics/claude2api
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+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 :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28.0
+Requires-Dist: sseclient-py>=1.8.0
+Dynamic: license-file
+
+# claude2api-client
+
+Python client for the [claude2Api](https://github.com/anthropics/claude2api) bridge service — call Claude Code's full capabilities (file I/O, Bash, multi-turn conversations) over HTTP from any Python project.
+
+## Prerequisites
+
+A running **claude2Api** Node.js bridge service. See the [main repo](https://github.com/anthropics/claude2api) for setup instructions.
+
+## Installation
+
+```bash
+pip install claude2api-client
+```
+
+## Quick Start
+
+```python
+from claude2api_client import Claude2Api
+
+api = Claude2Api("http://localhost:3456")
+
+# Single turn
+r = api.chat("Explain Python GIL in one sentence")
+print(r.result)
+
+# Multi-turn conversation
+r2 = api.chat("How about JavaScript?", session_id=r.session_id)
+print(r2.result)
+```
+
+## Streaming
+
+```python
+def on_stream(data):
+    if isinstance(data.get("content"), list):
+        for block in data["content"]:
+            if isinstance(block, dict) and block.get("type") == "text":
+                print(block["text"], end="", flush=True)
+
+r = api.chat("Write a haiku", on_stream=on_stream)
+```
+
+## API Reference
+
+### `Claude2Api(base_url, timeout)`
+
+| Param | Default | Description |
+|-------|---------|-------------|
+| `base_url` | `http://localhost:3456` | Bridge service URL |
+| `timeout` | `300` | Request timeout in seconds |
+
+### `chat(prompt, **kwargs) -> ChatResult`
+
+| Param | Type | Description |
+|-------|------|-------------|
+| `prompt` | `str` | Message to send (required) |
+| `session_id` | `str` | Resume an existing session |
+| `cwd` | `str` | Working directory for file operations |
+| `model` | `str` | Model ID, e.g. `"claude-sonnet-4-6"` |
+| `allowed_tools` | `list` | e.g. `["Read", "Edit", "Bash"]` |
+| `max_turns` | `int` | Max agent turns |
+| `system_prompt` | `str` | Custom system prompt |
+| `on_stream` | `callable` | Callback for intermediate SSE events |
+
+### `ChatResult`
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `session_id` | `str \| None` | Session identifier |
+| `result` | `str \| None` | Final response text |
+| `cost` | `float \| None` | Token cost |
+| `duration` | `float \| None` | Execution time |
+| `is_error` | `bool` | Whether an error occurred |
+| `error` | `str \| None` | Error message |
+
+### Utility methods
+
+- `health() -> dict` — Health check
+- `sessions() -> list` — List active sessions
+- `abort(session_id) -> dict` — Abort a running session
+
+## Publishing to PyPI
+
+```bash
+# Build
+cd python
+python -m build
+
+# Upload to PyPI
+twine upload dist/*
+# username: __token__
+# password: your PyPI API token (https://pypi.org/manage/account/token/)
+
+# Or test on TestPyPI first
+twine upload --repository testpypi dist/*
+pip install --index-url https://test.pypi.org/simple/ claude2api
+```
+
+To skip entering credentials every time, create `~/.pypirc`:
+
+```ini
+[distutils]
+index-servers =
+    pypi
+    testpypi
+
+[pypi]
+username = __token__
+password = pypi-xxxxxxxxxxxxxxxx
+
+[testpypi]
+repository = https://test.pypi.org/legacy/
+username = __token__
+password = pypi-xxxxxxxxxxxxxxxx
+```
+
+To release a new version, update `version` in both `pyproject.toml` and `claude2api_client/__init__.py`, then rebuild and upload.
+
+## License
+
+MIT

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

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+claude2api_client/__init__.py
+claude2api_client/client.py
+claude2api_client/py.typed
+claude2api_client.egg-info/PKG-INFO
+claude2api_client.egg-info/SOURCES.txt
+claude2api_client.egg-info/dependency_links.txt
+claude2api_client.egg-info/requires.txt
+claude2api_client.egg-info/top_level.txt

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

@@ -0,0 +1 @@
+

claude2api_client-0.1.0/claude2api_client.egg-info/requires.txt

@@ -0,0 +1,2 @@
+requests>=2.28.0
+sseclient-py>=1.8.0

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

@@ -0,0 +1 @@
+claude2api_client

claude2api_client-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["setuptools>=64", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "claude2api-client"
+version = "0.1.0"
+description = "Python client for claude2Api bridge service"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.8"
+authors = [
+    { name = "claude2api contributors" },
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "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",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = [
+    "requests>=2.28.0",
+    "sseclient-py>=1.8.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/anthropics/claude2api"
+Repository = "https://github.com/anthropics/claude2api"
+
+[tool.setuptools.packages.find]
+include = ["claude2api_client*"]
+
+[tool.setuptools.package-data]
+claude2api_client = ["py.typed"]

claude2api_client-0.1.0/setup.cfg

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