Metadata-Version: 2.4
Name: fiddler-client
Version: 3.12.0rc1
Summary: Python client for Fiddler Platform
Author: Fiddler Labs
License-Expression: Apache-2.0
Project-URL: Homepage, https://fiddler.ai
Classifier: Programming Language :: Python :: 3
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: Programming Language :: Python :: 3.14
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: requests<3
Requires-Dist: requests-toolbelt
Requires-Dist: pydantic>=2.0
Requires-Dist: deprecated>=1.2.18
Requires-Dist: tqdm
Requires-Dist: simplejson>=3.17.0
Requires-Dist: pyyaml
Requires-Dist: typing-extensions<5,>=4.6.0
Requires-Dist: pandas>=2.1.0
Requires-Dist: pyarrow>=17.0.0
Dynamic: license-file

# fiddler-client

[![Python Version](https://img.shields.io/pypi/pyversions/fiddler-client.svg)](https://pypi.org/project/fiddler-client/)
[![PyPI Version](https://img.shields.io/pypi/v/fiddler-client.svg)](https://pypi.org/project/fiddler-client/)
[![License](https://img.shields.io/pypi/l/fiddler-client.svg)](https://pypi.org/project/fiddler-client/)

The official Python client for [Fiddler](https://www.fiddler.ai), the enterprise-grade AI Observability platform. Monitor, analyze, and protect your ML models, LLMs, GenAI applications, and AI Agents in production.

## Platform Features

- 🚀 **Easy Integration** - Simple Python API for model and GenAI application onboarding
- 📊 **Real-time Monitoring** - Stream production events for drift detection, performance tracking, and anomaly detection
- 🎯 **Data Drift & Integrity** - Detect distribution changes, data quality issues, and schema violations
- 📈 **Custom Metrics** - Define and track business KPIs, custom performance metrics, and model-specific measurements
- 🔍 **Data Segments** - Analyze model behavior across cohorts with custom segments and slices
- 🤖 **GenAI & LLM Monitoring** - Track hallucinations, toxicity, PII leakage, prompt injection, and response quality
- 🛡️ **Guardrails** - Real-time protection against unsafe outputs and policy violations in LLM applications
- 📊 **Enrichments** - Add embeddings, sentiment, topics, and other ML-derived features to your data
- 🔄 **Model Comparison** - Compare performance across model versions, champion/challenger analysis
- 🎨 **Custom Dashboards** - Build tailored monitoring views with charts, alerts, and analytics
- 🔔 **Smart Alerts** - Multi-channel notifications (Slack, Email, PagerDuty) with customizable thresholds
- 🤝 **MLOps Integrations** - Native support for MLflow, SageMaker, Vertex AI, and other platforms

## Installation

```bash
pip install fiddler-client
```

## Requirements

- Python 3.10 or higher
- pip 19.0 or higher (latest release preferred)

## Quick Start

```python
import fiddler as fdl

# Initialize the client
fdl.init(
    url='https://your-company.fiddler.ai',
    token='your-api-token'
)

# List the existing projects
for project in fdl.Project.list():
    print(project.name)
```

## Documentation

* 📚 [Complete Documentation](https://docs.fiddler.ai/)
* 🚀 [Getting Started with LLMs](https://docs.fiddler.ai/getting-started/llm-monitoring)
* 🚀 [Getting Started with ML](https://docs.fiddler.ai/getting-started/ml-observability)
* 🤖 [Getting Started with Agentic Monitoring](https://docs.fiddler.ai/getting-started/agentic-monitoring)
* 📖 [API Reference](https://docs.fiddler.ai/api/fiddler-python-client-sdk/python-client)
* 💡 [Example Notebooks](https://github.com/fiddler-labs/fiddler-examples)

## Example Notebooks

Check out our [GitHub repository](https://github.com/fiddler-labs/fiddler-examples) for Jupyter notebooks demonstrating:

- Model onboarding and monitoring setup
- Drift detection and root cause analysis
- Custom metrics and alerting
- LLM and GenAI monitoring
- Integration with popular ML frameworks

## Version History

See our [release notes](https://docs.fiddler.ai/changelog/release-notes/python-sdk) for detailed version history.

## Support

- 📧 Email: [support@fiddler.ai](mailto:support@fiddler.ai)
- 💬 Community: [Join our Slack](https://www.fiddler.ai/slackinvite)

## License

This package is proprietary software. Please refer to your Fiddler license agreement for terms of use.

---

**Want to see Fiddler in action?** [Request a demo](https://www.fiddler.ai/demo)
