---
name: Bug Report
about: Report a bug to help us improve Headroom
title: '[BUG] '
labels: bug
assignees: ''
---

## Description

A clear and concise description of what the bug is.

## To Reproduce

Steps to reproduce the behavior:

1. Install headroom with '...'
2. Run this code '...'
3. See error

## Expected Behavior

What you expected to happen.

## Actual Behavior

What actually happened.

## Code Sample

```python
# Minimal code to reproduce the issue
from headroom import HeadroomClient

# Your code here
```

## Error Output

```
Paste any error messages or stack traces here
```

## Environment

- **Headroom version**: (run `python -c "import headroom; print(headroom.__version__)"`)
- **Python version**: (run `python --version`)
- **OS**: (e.g., macOS 14.0, Ubuntu 22.04, Windows 11)
- **LLM Provider**: (e.g., OpenAI, Anthropic)

## Additional Context

Add any other context about the problem here (logs, screenshots, etc.)
