claude2api-client

Python client for the 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 for setup instructions.

Installation

pip install claude2api-client

Quick Start

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

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)

chat(prompt, **kwargs) -> ChatResult

ChatResult

Utility methods

• health() -> dict — Health check
• sessions() -> list — List active sessions
• abort(session_id) -> dict — Abort a running session

Publishing to PyPI

# 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:

[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