# OpenTelemetry HuggingFace Transformers Instrumentation
<a href="https://pypi.org/project/opentelemetry-instrumentation-transformers/">
<img src="https://badge.fury.io/py/opentelemetry-instrumentation-transformers.svg">
</a>
This library allows tracing texte generation calls sent with the official [HuggingFace Transformers library](https://github.com/huggingface/transformers).
## Installation
```bash
pip install opentelemetry-instrumentation-transformers
```
## Example usage
```python
from opentelemetry.instrumentation.transformers import TransformersInstrumentor
TransformersInstrumentor().instrument()
```
## Privacy
**By default, this instrumentation logs prompts, completions, and embeddings to span attributes**. This gives you a clear visibility into how your LLM application is working, and can make it easy to debug and evaluate the quality of the outputs.
However, you may want to disable this logging for privacy reasons, as they may contain highly sensitive data from your users. You may also simply want to reduce the size of your traces.
To disable logging, set the `TRACELOOP_TRACE_CONTENT` environment variable to `false`.
```bash
TRACELOOP_TRACE_CONTENT=false
```
Raw data
{
"_id": null,
"home_page": null,
"name": "opentelemetry-instrumentation-transformers",
"maintainer": null,
"docs_url": null,
"requires_python": "<4,>=3.9",
"maintainer_email": null,
"keywords": null,
"author": "Gal Kleinman",
"author_email": "gal@traceloop.com",
"download_url": "https://files.pythonhosted.org/packages/cb/e9/c9745b9670fd880de7af30b2e4a72ce42ac6aa38eacdb2dcd570a771ee33/opentelemetry_instrumentation_transformers-0.44.1.tar.gz",
"platform": null,
"description": "# OpenTelemetry HuggingFace Transformers Instrumentation\n\n<a href=\"https://pypi.org/project/opentelemetry-instrumentation-transformers/\">\n <img src=\"https://badge.fury.io/py/opentelemetry-instrumentation-transformers.svg\">\n</a>\n\nThis library allows tracing texte generation calls sent with the official [HuggingFace Transformers library](https://github.com/huggingface/transformers).\n\n## Installation\n\n```bash\npip install opentelemetry-instrumentation-transformers\n```\n\n## Example usage\n\n```python\nfrom opentelemetry.instrumentation.transformers import TransformersInstrumentor\n\nTransformersInstrumentor().instrument()\n```\n\n## Privacy\n\n**By default, this instrumentation logs prompts, completions, and embeddings to span attributes**. This gives you a clear visibility into how your LLM application is working, and can make it easy to debug and evaluate the quality of the outputs.\n\nHowever, you may want to disable this logging for privacy reasons, as they may contain highly sensitive data from your users. You may also simply want to reduce the size of your traces.\n\nTo disable logging, set the `TRACELOOP_TRACE_CONTENT` environment variable to `false`.\n\n```bash\nTRACELOOP_TRACE_CONTENT=false\n```\n\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "OpenTelemetry transformers instrumentation",
"version": "0.44.1",
"project_urls": {
"Repository": "https://github.com/traceloop/openllmetry/tree/main/packages/opentelemetry-instrumentation-transformers"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "82d97f9692de01e64821411c70e022780375cdfb93be19c276dbbf7b21ec7aa8",
"md5": "1370ab2f5d9d3452e725173a491b2a01",
"sha256": "79c6aeabba7f435e929aa9f8147cf5ace8ceba13da69d1e17a2360f05595d914"
},
"downloads": -1,
"filename": "opentelemetry_instrumentation_transformers-0.44.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "1370ab2f5d9d3452e725173a491b2a01",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4,>=3.9",
"size": 8211,
"upload_time": "2025-08-04T08:39:51",
"upload_time_iso_8601": "2025-08-04T08:39:51.533951Z",
"url": "https://files.pythonhosted.org/packages/82/d9/7f9692de01e64821411c70e022780375cdfb93be19c276dbbf7b21ec7aa8/opentelemetry_instrumentation_transformers-0.44.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "cbe9c9745b9670fd880de7af30b2e4a72ce42ac6aa38eacdb2dcd570a771ee33",
"md5": "bdcf77cf59404ddff5543454edc4640b",
"sha256": "100d31e712c761d501d11c1437eb4e134dbdf83bb826199e0f24cb0040d82337"
},
"downloads": -1,
"filename": "opentelemetry_instrumentation_transformers-0.44.1.tar.gz",
"has_sig": false,
"md5_digest": "bdcf77cf59404ddff5543454edc4640b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4,>=3.9",
"size": 5859,
"upload_time": "2025-08-04T08:40:17",
"upload_time_iso_8601": "2025-08-04T08:40:17.946033Z",
"url": "https://files.pythonhosted.org/packages/cb/e9/c9745b9670fd880de7af30b2e4a72ce42ac6aa38eacdb2dcd570a771ee33/opentelemetry_instrumentation_transformers-0.44.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-04 08:40:17",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "traceloop",
"github_project": "openllmetry",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "opentelemetry-instrumentation-transformers"
}
JSON
