Metadata-Version: 2.4
Name: coolhand
Version: 0.1.0
Summary: A Python SDK for monitoring and analyzing AI API interactions with LLM services
Project-URL: Homepage, https://github.com/Coolhand-Labs/coolhand-python
Project-URL: Repository, https://github.com/Coolhand-Labs/coolhand-python.git
Project-URL: Bug Tracker, https://github.com/Coolhand-Labs/coolhand-python/issues
Author-email: Michael Carroll <team@coolhandlabs.com>
Maintainer-email: Michael Carroll <team@coolhandlabs.com>
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: ai,analytics,anthropic,api,claude,gpt,llm,monitoring,openai
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
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: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.7
Requires-Dist: typing-extensions>=3.7.0
Provides-Extra: dev
Requires-Dist: black>=23.0.0; extra == 'dev'
Requires-Dist: flake8>=6.0.0; extra == 'dev'
Requires-Dist: isort>=5.12.0; extra == 'dev'
Requires-Dist: mypy>=1.0.0; extra == 'dev'
Requires-Dist: pre-commit>=3.0.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Provides-Extra: test
Requires-Dist: httpx>=0.20.0; extra == 'test'
Requires-Dist: pytest-cov>=4.0.0; extra == 'test'
Requires-Dist: pytest>=7.0.0; extra == 'test'
Requires-Dist: requests>=2.25.0; extra == 'test'
Description-Content-Type: text/markdown

# Coolhand Python

Automatic monitoring for LLM API calls in Python applications.

## Installation

```bash
pip install coolhand
```

## Quick Start

```python
import coolhand  # Auto-initializes and starts monitoring

# All LLM API calls are now automatically captured
from openai import OpenAI
client = OpenAI()
response = client.chat.completions.create(
    model="gpt-4",
    messages=[{"role": "user", "content": "Hello!"}]
)
```

## Manual Configuration

```python
from coolhand import Coolhand

coolhand_client = Coolhand(
    api_key='your-api-key',
    silent=False,  # Enable verbose logging
)
```

## Environment Variables

- `COOLHAND_API_KEY`: Your Coolhand API key
- `COOLHAND_SILENT`: Set to `false` for verbose logging

## Supported LLM APIs

Automatically captures requests to:
- OpenAI (api.openai.com)
- Anthropic (api.anthropic.com)

## Requirements

- Python 3.7+
- httpx (for HTTP client patching)

## License

Apache-2.0
