bitfrost 0.1.0b1__tar.gz

bitfrost-0.1.0b1/.gitignore

@@ -0,0 +1,107 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Environments
+.env
+.env.local
+.env.*.local
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# IDEs
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Ruff
+.ruff_cache/
+
+# Type checking
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# Pyenv
+.python-version.local
+
+# Local development
+*.local
+scratch/
+notes-local.md
+
+# SQLite databases (bitfrost test artifacts)
+*.sqlite
+*.sqlite3
+*.db
+
+# JSONL test artifacts
+*.jsonl
+
+# Generated docs
+docs/_build/
+site/

bitfrost-0.1.0b1/CHANGELOG.md

@@ -0,0 +1,33 @@
+# Changelog
+
+All notable changes to `bitfrost` are documented here.
+
+The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] — 2026-06-04
+
+First public release.
+
+### Added
+
+- **OpenTelemetry SpanExporter** (`BitfrostExporter`) that maps GenAI spans to a
+  normalized event shape, supporting both the v1.27 and v1.32+ semantic-convention
+  attribute generations.
+- **Five backends**: `ConsoleBackend` (rich terminal), `SQLiteBackend` (persistent
+  local log, WAL mode), `JSONLBackend` (replay-able), `OTLPBackend` (JSON over HTTP
+  to any collector/webhook), and `VoightBackend` (optional hosted dashboards), plus
+  `TeeBackend` to fan out to several at once.
+- **Auto-instrument helpers**: `instrument_openai`, `instrument_anthropic`,
+  `instrument_litellm`, `instrument_smolagents`, `instrument_auto`, and `quickstart`.
+- **CLI**: `bitfrost watch / replay / query / vacuum / tui / serve`.
+- **Interactive TUI** (`bitfrost tui`) and an **offline web dashboard**
+  (`bitfrost serve`) with live charts, filters, per-span detail, and an SSE feed.
+- **Privacy**: three levels (`minimal` / `standard` / `full`) with PII scrubbing
+  (12 patterns + credit-card Luhn) applied in-process before export.
+- **Embedded pricing** for local cost estimates (top models; Decimal arithmetic).
+
+### Notes
+
+- Python 3.10–3.13. MIT licensed.
+- The core has no dependency on any hosted service; Voight is opt-in.

bitfrost-0.1.0b1/LICENSE

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

bitfrost-0.1.0b1/PKG-INFO

@@ -0,0 +1,217 @@
+Metadata-Version: 2.4
+Name: bitfrost
+Version: 0.1.0b1
+Summary: Drop-in OpenTelemetry observability for Python LLM apps. Standalone or with any OTLP backend.
+Project-URL: Homepage, https://voight.xyz
+Project-URL: Documentation, https://docs.voight.xyz/python/bitfrost
+Project-URL: Repository, https://github.com/Voightxyz/bitfrost
+Project-URL: Issues, https://github.com/Voightxyz/bitfrost/issues
+Project-URL: Changelog, https://github.com/Voightxyz/bitfrost/blob/main/CHANGELOG.md
+Author-email: Voight <hello@voight.xyz>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: anthropic,gen-ai,litellm,llm,monitoring,observability,openai,opentelemetry,otel,smolagents,tracing
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+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: Topic :: System :: Monitoring
+Classifier: Typing :: Typed
+Requires-Python: <3.14,>=3.10
+Requires-Dist: opentelemetry-api>=1.27
+Requires-Dist: opentelemetry-sdk>=1.27
+Provides-Extra: all
+Requires-Dist: httpx<1.0,>=0.24; extra == 'all'
+Requires-Dist: rich>=13.0; extra == 'all'
+Requires-Dist: sse-starlette>=2.0; extra == 'all'
+Requires-Dist: starlette>=0.40; extra == 'all'
+Requires-Dist: textual>=0.50; extra == 'all'
+Requires-Dist: typer>=0.12; extra == 'all'
+Requires-Dist: uvicorn>=0.30; extra == 'all'
+Provides-Extra: cli
+Requires-Dist: rich>=13.0; extra == 'cli'
+Requires-Dist: typer>=0.12; extra == 'cli'
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.6; extra == 'dev'
+Requires-Dist: twine>=5.0; extra == 'dev'
+Provides-Extra: http
+Requires-Dist: httpx<1.0,>=0.24; extra == 'http'
+Provides-Extra: rich
+Requires-Dist: rich>=13.0; extra == 'rich'
+Provides-Extra: serve
+Requires-Dist: rich>=13.0; extra == 'serve'
+Requires-Dist: sse-starlette>=2.0; extra == 'serve'
+Requires-Dist: starlette>=0.40; extra == 'serve'
+Requires-Dist: uvicorn>=0.30; extra == 'serve'
+Provides-Extra: test
+Requires-Dist: anthropic>=0.40; extra == 'test'
+Requires-Dist: litellm>=1.40; extra == 'test'
+Requires-Dist: openai>=1.40; extra == 'test'
+Requires-Dist: openinference-instrumentation-smolagents>=0.1; extra == 'test'
+Requires-Dist: opentelemetry-instrumentation-anthropic>=0.30; extra == 'test'
+Requires-Dist: opentelemetry-instrumentation-openai>=0.30; extra == 'test'
+Requires-Dist: smolagents>=1.0; extra == 'test'
+Requires-Dist: textual>=0.50; extra == 'test'
+Provides-Extra: tui
+Requires-Dist: textual>=0.50; extra == 'tui'
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+<img src="https://raw.githubusercontent.com/Voightxyz/bitfrost/main/assets/logo.svg" alt="bitfrost" height="56" />
+
+# bitfrost
+
+**Drop-in OpenTelemetry observability for Python LLM apps.**
+Standalone or with any OTLP backend — runs on your machine, sends nothing unless you ask it to.
+
+[![PyPI](https://img.shields.io/pypi/v/bitfrost.svg)](https://pypi.org/project/bitfrost/)
+[![Python](https://img.shields.io/pypi/pyversions/bitfrost.svg)](https://pypi.org/project/bitfrost/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![CI](https://github.com/Voightxyz/bitfrost/actions/workflows/ci.yml/badge.svg)](https://github.com/Voightxyz/bitfrost/actions/workflows/ci.yml)
+
+</div>
+
+---
+
+Bitfrost turns the OpenTelemetry spans your LLM libraries already emit into a clean, queryable event stream — in your terminal, in a local web dashboard, in SQLite, or shipped to any backend you choose. One line to start, zero accounts required.
+
+```python
+import bitfrost
+
+bitfrost.quickstart(agent="my-app")   # auto-detects openai / anthropic / litellm / smolagents
+# ...your normal LLM calls now stream to the terminal, color-coded, with tokens + cost.
+```
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/Voightxyz/bitfrost/main/assets/dashboard.png" alt="bitfrost serve — local web dashboard" width="100%" />
+  <br />
+  <em><code>bitfrost serve capture.db</code> — a local, offline dashboard. No account, no upload.</em>
+</div>
+
+## Why bitfrost
+
+- **Standalone first.** Capture to your terminal, a JSONL file, or SQLite with zero configuration and zero network calls. Voight is one optional backend, never a requirement.
+- **Drop-in.** Built on the OpenTelemetry GenAI semantic conventions, so it works with the instrumentation libraries you already use — across both the v1.27 and v1.32+ attribute generations.
+- **Batteries included.** Five backends, four auto-instrument helpers, a rich CLI, an interactive TUI, and an offline web dashboard.
+- **Private by default.** Three privacy levels with PII scrubbing (12 patterns + Luhn) applied before any event leaves the process.
+- **Never crashes your app.** Every failure path degrades gracefully — a dead endpoint or a missing optional dependency never takes down your code.
+
+## Install
+
+```bash
+pip install bitfrost                 # core
+pip install 'bitfrost[cli,serve]'    # + CLI, TUI and local web dashboard
+pip install 'bitfrost[all]'          # everything
+```
+
+Python 3.10–3.13.
+
+## Capture anywhere
+
+Pick a backend and pass it to any instrument helper (or `quickstart`). All concrete backends live under `bitfrost.backends.*`:
+
+| Backend | Import | Use it for |
+|---|---|---|
+| Console | `bitfrost.backends.console.ConsoleBackend` | live, color-coded terminal output |
+| SQLite | `bitfrost.backends.sqlite.SQLiteBackend` | persistent local log; powers `bitfrost serve` |
+| JSONL | `bitfrost.backends.jsonl.JSONLBackend` | one JSON object per line; replay-able |
+| OTLP/HTTP | `bitfrost.backends.otlp.OTLPBackend` | POST events as JSON to any collector or webhook |
+| Voight | `bitfrost.backends.voight.VoightBackend` | hosted dashboards (optional, opt-in) |
+| Tee | `bitfrost.backends.tee.TeeBackend` | fan out to several backends at once |
+
+```python
+import bitfrost
+from bitfrost.backends.sqlite import SQLiteBackend
+
+bitfrost.instrument_openai(backend=SQLiteBackend("events.db"), agent="my-app")
+# then:  bitfrost serve events.db
+```
+
+Fan out to several at once:
+
+```python
+import bitfrost
+from bitfrost.backends.tee import TeeBackend
+from bitfrost.backends.console import ConsoleBackend
+from bitfrost.backends.sqlite import SQLiteBackend
+
+bitfrost.instrument_auto(
+    backend=TeeBackend(ConsoleBackend(), SQLiteBackend("events.db")),
+    agent="my-app",
+)
+```
+
+## Auto-instrument helpers
+
+```python
+import bitfrost
+
+bitfrost.instrument_openai()       # opentelemetry-instrumentation-openai
+bitfrost.instrument_anthropic()    # opentelemetry-instrumentation-anthropic
+bitfrost.instrument_litellm()      # litellm CustomLogger adapter
+bitfrost.instrument_smolagents()   # openinference-instrumentation-smolagents
+bitfrost.instrument_auto()         # instrument every supported lib that's installed
+```
+
+Already wiring OpenTelemetry yourself? Skip the helpers and attach the exporter to your own `TracerProvider`:
+
+```python
+from opentelemetry.sdk.trace import TracerProvider
+from opentelemetry.sdk.trace.export import BatchSpanProcessor
+from bitfrost.exporter import BitfrostExporter
+from bitfrost.backends.console import ConsoleBackend
+
+provider = TracerProvider()
+provider.add_span_processor(
+    BatchSpanProcessor(BitfrostExporter(ConsoleBackend(), agent="my-app"))
+)
+```
+
+## CLI
+
+```bash
+bitfrost watch  capture.db        # live tail, one styled line per event
+bitfrost replay capture.jsonl     # re-render a captured run start to finish
+bitfrost query  capture.db "SELECT model, COUNT(*) FROM events GROUP BY model"
+bitfrost vacuum capture.db --keep-days 7
+bitfrost tui    capture.db        # full-screen interactive dashboard
+bitfrost serve  capture.db        # local web dashboard at http://127.0.0.1:8080
+```
+
+## Privacy
+
+Three levels, applied in-process before any event is sent:
+
+- `minimal` — metadata only, no prompt/response content
+- `standard` *(default)* — content kept, PII scrubbed (12 patterns + credit-card Luhn check)
+- `full` — everything verbatim (use only for local debugging)
+
+```python
+bitfrost.instrument_openai(privacy="minimal")
+```
+
+## Standalone, or with Voight
+
+Bitfrost is useful entirely on its own — the core has no dependency on any hosted service. If you want managed dashboards, team sharing, and per-user cost attribution, the optional `VoightBackend` ships your events to [voight.xyz](https://voight.xyz). Everything else stays exactly the same.
+
+## Documentation
+
+- [Cookbook](https://github.com/Voightxyz/bitfrost/blob/main/docs/cookbook.md) — task-oriented recipes
+- [Write your own backend](https://github.com/Voightxyz/bitfrost/blob/main/docs/custom_backend.md) — the `ExportBackend` protocol
+- Full docs: [docs.voight.xyz/python/bitfrost](https://docs.voight.xyz/python/bitfrost)
+
+## License
+
+MIT. Built by [Voight](https://voight.xyz).

bitfrost-0.1.0b1/README.md

@@ -0,0 +1,148 @@
+<div align="center">
+
+<img src="https://raw.githubusercontent.com/Voightxyz/bitfrost/main/assets/logo.svg" alt="bitfrost" height="56" />
+
+# bitfrost
+
+**Drop-in OpenTelemetry observability for Python LLM apps.**
+Standalone or with any OTLP backend — runs on your machine, sends nothing unless you ask it to.
+
+[![PyPI](https://img.shields.io/pypi/v/bitfrost.svg)](https://pypi.org/project/bitfrost/)
+[![Python](https://img.shields.io/pypi/pyversions/bitfrost.svg)](https://pypi.org/project/bitfrost/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+[![CI](https://github.com/Voightxyz/bitfrost/actions/workflows/ci.yml/badge.svg)](https://github.com/Voightxyz/bitfrost/actions/workflows/ci.yml)
+
+</div>
+
+---
+
+Bitfrost turns the OpenTelemetry spans your LLM libraries already emit into a clean, queryable event stream — in your terminal, in a local web dashboard, in SQLite, or shipped to any backend you choose. One line to start, zero accounts required.
+
+```python
+import bitfrost
+
+bitfrost.quickstart(agent="my-app")   # auto-detects openai / anthropic / litellm / smolagents
+# ...your normal LLM calls now stream to the terminal, color-coded, with tokens + cost.
+```
+
+<div align="center">
+  <img src="https://raw.githubusercontent.com/Voightxyz/bitfrost/main/assets/dashboard.png" alt="bitfrost serve — local web dashboard" width="100%" />
+  <br />
+  <em><code>bitfrost serve capture.db</code> — a local, offline dashboard. No account, no upload.</em>
+</div>
+
+## Why bitfrost
+
+- **Standalone first.** Capture to your terminal, a JSONL file, or SQLite with zero configuration and zero network calls. Voight is one optional backend, never a requirement.
+- **Drop-in.** Built on the OpenTelemetry GenAI semantic conventions, so it works with the instrumentation libraries you already use — across both the v1.27 and v1.32+ attribute generations.
+- **Batteries included.** Five backends, four auto-instrument helpers, a rich CLI, an interactive TUI, and an offline web dashboard.
+- **Private by default.** Three privacy levels with PII scrubbing (12 patterns + Luhn) applied before any event leaves the process.
+- **Never crashes your app.** Every failure path degrades gracefully — a dead endpoint or a missing optional dependency never takes down your code.
+
+## Install
+
+```bash
+pip install bitfrost                 # core
+pip install 'bitfrost[cli,serve]'    # + CLI, TUI and local web dashboard
+pip install 'bitfrost[all]'          # everything
+```
+
+Python 3.10–3.13.
+
+## Capture anywhere
+
+Pick a backend and pass it to any instrument helper (or `quickstart`). All concrete backends live under `bitfrost.backends.*`:
+
+| Backend | Import | Use it for |
+|---|---|---|
+| Console | `bitfrost.backends.console.ConsoleBackend` | live, color-coded terminal output |
+| SQLite | `bitfrost.backends.sqlite.SQLiteBackend` | persistent local log; powers `bitfrost serve` |
+| JSONL | `bitfrost.backends.jsonl.JSONLBackend` | one JSON object per line; replay-able |
+| OTLP/HTTP | `bitfrost.backends.otlp.OTLPBackend` | POST events as JSON to any collector or webhook |
+| Voight | `bitfrost.backends.voight.VoightBackend` | hosted dashboards (optional, opt-in) |
+| Tee | `bitfrost.backends.tee.TeeBackend` | fan out to several backends at once |
+
+```python
+import bitfrost
+from bitfrost.backends.sqlite import SQLiteBackend
+
+bitfrost.instrument_openai(backend=SQLiteBackend("events.db"), agent="my-app")
+# then:  bitfrost serve events.db
+```
+
+Fan out to several at once:
+
+```python
+import bitfrost
+from bitfrost.backends.tee import TeeBackend
+from bitfrost.backends.console import ConsoleBackend
+from bitfrost.backends.sqlite import SQLiteBackend
+
+bitfrost.instrument_auto(
+    backend=TeeBackend(ConsoleBackend(), SQLiteBackend("events.db")),
+    agent="my-app",
+)
+```
+
+## Auto-instrument helpers
+
+```python
+import bitfrost
+
+bitfrost.instrument_openai()       # opentelemetry-instrumentation-openai
+bitfrost.instrument_anthropic()    # opentelemetry-instrumentation-anthropic
+bitfrost.instrument_litellm()      # litellm CustomLogger adapter
+bitfrost.instrument_smolagents()   # openinference-instrumentation-smolagents
+bitfrost.instrument_auto()         # instrument every supported lib that's installed
+```
+
+Already wiring OpenTelemetry yourself? Skip the helpers and attach the exporter to your own `TracerProvider`:
+
+```python
+from opentelemetry.sdk.trace import TracerProvider
+from opentelemetry.sdk.trace.export import BatchSpanProcessor
+from bitfrost.exporter import BitfrostExporter
+from bitfrost.backends.console import ConsoleBackend
+
+provider = TracerProvider()
+provider.add_span_processor(
+    BatchSpanProcessor(BitfrostExporter(ConsoleBackend(), agent="my-app"))
+)
+```
+
+## CLI
+
+```bash
+bitfrost watch  capture.db        # live tail, one styled line per event
+bitfrost replay capture.jsonl     # re-render a captured run start to finish
+bitfrost query  capture.db "SELECT model, COUNT(*) FROM events GROUP BY model"
+bitfrost vacuum capture.db --keep-days 7
+bitfrost tui    capture.db        # full-screen interactive dashboard
+bitfrost serve  capture.db        # local web dashboard at http://127.0.0.1:8080
+```
+
+## Privacy
+
+Three levels, applied in-process before any event is sent:
+
+- `minimal` — metadata only, no prompt/response content
+- `standard` *(default)* — content kept, PII scrubbed (12 patterns + credit-card Luhn check)
+- `full` — everything verbatim (use only for local debugging)
+
+```python
+bitfrost.instrument_openai(privacy="minimal")
+```
+
+## Standalone, or with Voight
+
+Bitfrost is useful entirely on its own — the core has no dependency on any hosted service. If you want managed dashboards, team sharing, and per-user cost attribution, the optional `VoightBackend` ships your events to [voight.xyz](https://voight.xyz). Everything else stays exactly the same.
+
+## Documentation
+
+- [Cookbook](https://github.com/Voightxyz/bitfrost/blob/main/docs/cookbook.md) — task-oriented recipes
+- [Write your own backend](https://github.com/Voightxyz/bitfrost/blob/main/docs/custom_backend.md) — the `ExportBackend` protocol
+- Full docs: [docs.voight.xyz/python/bitfrost](https://docs.voight.xyz/python/bitfrost)
+
+## License
+
+MIT. Built by [Voight](https://voight.xyz).

bitfrost-0.1.0b1/pyproject.toml

@@ -0,0 +1,164 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "bitfrost"
+version = "0.1.0b1"
+description = "Drop-in OpenTelemetry observability for Python LLM apps. Standalone or with any OTLP backend."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.10,<3.14"
+authors = [
+    { name = "Voight", email = "hello@voight.xyz" },
+]
+keywords = [
+    "opentelemetry",
+    "otel",
+    "observability",
+    "llm",
+    "gen-ai",
+    "openai",
+    "anthropic",
+    "smolagents",
+    "litellm",
+    "tracing",
+    "monitoring",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "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",
+    "Topic :: System :: Monitoring",
+    "Typing :: Typed",
+]
+dependencies = [
+    "opentelemetry-api>=1.27",
+    "opentelemetry-sdk>=1.27",
+]
+
+[project.optional-dependencies]
+http = [
+    "httpx>=0.24,<1.0",
+]
+rich = [
+    "rich>=13.0",
+]
+cli = [
+    "typer>=0.12",
+    "rich>=13.0",
+]
+serve = [
+    "starlette>=0.40",
+    "uvicorn>=0.30",
+    "sse-starlette>=2.0",
+    "rich>=13.0",
+]
+tui = [
+    "textual>=0.50",
+]
+all = [
+    "bitfrost[http,rich,cli,serve,tui]",
+]
+dev = [
+    "pytest>=8.0",
+    "pytest-cov>=5.0",
+    "ruff>=0.6",
+    "mypy>=1.10",
+    "build>=1.2",
+    "twine>=5.0",
+]
+# Integration libraries the test suite + mypy need present. Bitfrost
+# imports these lazily (they're the user's deps, not ours), but the
+# unit tests patch their instrumentors and the LiteLLM adapter
+# subclasses litellm's CustomLogger — so CI must install them for the
+# suite to run and for mypy to see real types instead of Any. Kept in a
+# dedicated group so a plain `pip install bitfrost[dev]` for docs/lint
+# work doesn't drag in litellm + smolagents.
+test = [
+    # The instrumentation packages import the underlying SDK at module
+    # load (the openai/anthropic instrumentors `import openai` /
+    # `import anthropic`), so the SDKs themselves must be present for the
+    # instrumentor submodules to import at all.
+    "openai>=1.40",
+    "anthropic>=0.40",
+    "opentelemetry-instrumentation-openai>=0.30",
+    "opentelemetry-instrumentation-anthropic>=0.30",
+    "litellm>=1.40",
+    "smolagents>=1.0",
+    "openinference-instrumentation-smolagents>=0.1",
+    "textual>=0.50",
+]
+
+[project.urls]
+Homepage = "https://voight.xyz"
+Documentation = "https://docs.voight.xyz/python/bitfrost"
+Repository = "https://github.com/Voightxyz/bitfrost"
+Issues = "https://github.com/Voightxyz/bitfrost/issues"
+Changelog = "https://github.com/Voightxyz/bitfrost/blob/main/CHANGELOG.md"
+
+[project.scripts]
+bitfrost = "bitfrost.cli:app"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/bitfrost"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src",
+    "/tests",
+    "/README.md",
+    "/CHANGELOG.md",
+    "/LICENSE",
+    "/pyproject.toml",
+]
+
+[tool.pytest.ini_options]
+minversion = "8.0"
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+addopts = [
+    "-ra",
+    "--strict-markers",
+    "--strict-config",
+]
+filterwarnings = [
+    "error",
+    "ignore::DeprecationWarning",
+    # starlette 1.2+ emits a deprecation when its TestClient is used with
+    # httpx (it plans to switch to httpx2). httpx still works and the
+    # TestClient is test-only, so we silence it rather than pin starlette
+    # or add an unstable dep. Matched by message so the filter needs no
+    # importable warning class (works even in a serve-less install).
+    "ignore:Using `httpx` with `starlette.testclient`:",
+]
+
+[tool.coverage.run]
+source = ["src/bitfrost"]
+branch = true
+parallel = true
+
+[tool.coverage.report]
+exclude_lines = [
+    "pragma: no cover",
+    "raise NotImplementedError",
+    "if TYPE_CHECKING:",
+    "if __name__ == .__main__.:",
+    "\\.\\.\\.",
+]
+show_missing = true
+skip_covered = false
+
+[tool.coverage.paths]
+source = ["src", ".tox/*/lib/python*/site-packages"]