Metadata-Version: 2.4
Name: tokenbin
Version: 0.1.1
Summary: First-party Python client for the Tokenbin artifact and directory kernel.
Author: Tyler O'Briant
License-Expression: ISC
Project-URL: Homepage, https://github.com/Tetra-Research/tokenbin/tree/main/clients/python#readme
Project-URL: Repository, https://github.com/Tetra-Research/tokenbin
Project-URL: Issues, https://github.com/Tetra-Research/tokenbin/issues
Keywords: tokenbin,mcp,artifacts,coordination,python
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# `tokenbin`

First-party Python client for the Tokenbin artifact and directory kernel.

Install from PyPI after the first registry release:

```bash
python3 -m pip install tokenbin
```

For a local repo checkout:

```bash
python3 -m pip install ./clients/python
```

Example:

```python
import os

from tokenbin import TokenbinClient

client = TokenbinClient(
    base_url=os.environ["TOKENBIN_URL"],
    token=os.environ.get("TOKENBIN_AUTH_TOKEN") or os.environ["TOKENBIN_API_KEY"],
)

created = client.paste(
    {
        "content": "support draft",
        "directory": "support/zendesk/9981",
        "directory_metadata": {"kind": "comment-draft", "agent": "agent-a"},
    }
)

print(created["id"])
```

The client is a thin wrapper over Tokenbin's authenticated JSON API and versioned OpenAPI contract. For the full API, MCP, CLI, and deployment docs, see the repository root README.
