| Name | observare-sdk JSON |
| Version |
1.0.5
JSON |
| download |
| home_page | None |
| Summary | Observability / Telemetry and Safety SDK for LangChain agents with PII redaction and hallucination detection |
| upload_time | 2025-08-07 00:36:56 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.8 |
| license | Proprietary |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Observare SDK
**Zero-config telemetry and safety for LangChain agents**
Add comprehensive observability, PII redaction, and hallucination detection to your LangChain applications with minimal setup.
## 🚀 Quick Start
### Installation
```bash
pip install observare-sdk
```
### Basic Telemetry
```python
from observare_sdk import AutoTelemetryHandler
from langchain_openai import ChatOpenAI
from langchain.agents import AgentExecutor
# Add telemetry to any LangChain agent
handler = AutoTelemetryHandler(api_key="your-api-key")
executor = AgentExecutor(
agent=agent,
tools=tools,
callbacks=[handler] # One line integration!
)
# All agent activity is now tracked automatically
result = executor.invoke({"input": "What's the weather?"})
```
### Safety Features
```python
from observare_sdk import ObservareChat, SafetyPolicy
from langchain_openai import ChatOpenAI
# Wrap any LLM with safety features
safe_llm = ObservareChat(
llm=ChatOpenAI(model="gpt-3.5-turbo"),
api_key="your-api-key"
)
# Apply safety policy
safe_llm.apply_policy(SafetyPolicy.BALANCED)
# PII is automatically redacted, hallucinations detected
response = safe_llm.invoke([HumanMessage(content="My SSN is 123-45-6789")])
# → "My SSN is [SSN_REDACTED]"
```
## ✨ Features
### 📊 **Zero-Config Telemetry**
- **Agent lifecycle tracking** - Start, completion, errors
- **Tool execution monitoring** - Performance and usage
- **LLM call metrics** - Token usage, costs, latency
- **Automatic correlation** - Link related events together
### 🛡️ **Enterprise Safety**
- **PII Redaction** - Emails, phones, SSNs, credit cards
- **Hallucination Detection** - Multi-method AI safety validation
- **Configurable Policies** - STRICT, BALANCED, PERMISSIVE
- **Real-time Monitoring** - Live safety alerts
### 🔧 **Production Ready**
- **Fail-safe operation** - Never breaks your app
- **High performance** - Minimal latency overhead
- **Comprehensive logging** - Full audit trails
- **Easy integration** - Works with existing code
## ⚙️ Configuration
### Environment Variables
```bash
export OBSERVARE_API_KEY="your-api-key"
```
### Safety Policies
```python
# Maximum security
safe_llm.apply_policy(SafetyPolicy.STRICT)
# Balanced (default)
safe_llm.apply_policy(SafetyPolicy.BALANCED)
# Minimal restrictions
safe_llm.apply_policy(SafetyPolicy.PERMISSIVE)
```
### Debug Mode
```python
# See API errors during development
handler = AutoTelemetryHandler(api_key="your-key", debug_mode=True)
```
## 🆘 Support
- **Documentation**: [docs.observare.ai](https://docs.observare.ai)
- **Issues**: [github.com/observare/sdk/issues](https://github.com/observare/sdk/issues)
- **Email**: support@observare.ai
## 📄 License
Proprietary - See LICENSE file for details.
---
**Get started in 2 minutes:** Add one line to your LangChain app and gain complete visibility into your AI systems.
Raw data
{
"_id": null,
"home_page": null,
"name": "observare-sdk",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": null,
"author": null,
"author_email": "Observare <support@observare.ai>",
"download_url": "https://files.pythonhosted.org/packages/1b/d6/746c0f71a39b90fd05b6fc738dce97102427296d178220de100f808ac894/observare_sdk-1.0.5.tar.gz",
"platform": null,
"description": "# Observare SDK\n\n**Zero-config telemetry and safety for LangChain agents**\n\nAdd comprehensive observability, PII redaction, and hallucination detection to your LangChain applications with minimal setup.\n\n## \ud83d\ude80 Quick Start\n\n### Installation\n```bash\npip install observare-sdk\n```\n\n### Basic Telemetry\n```python\nfrom observare_sdk import AutoTelemetryHandler\nfrom langchain_openai import ChatOpenAI\nfrom langchain.agents import AgentExecutor\n\n# Add telemetry to any LangChain agent\nhandler = AutoTelemetryHandler(api_key=\"your-api-key\")\nexecutor = AgentExecutor(\n agent=agent, \n tools=tools,\n callbacks=[handler] # One line integration!\n)\n\n# All agent activity is now tracked automatically\nresult = executor.invoke({\"input\": \"What's the weather?\"})\n```\n\n### Safety Features\n```python\nfrom observare_sdk import ObservareChat, SafetyPolicy\nfrom langchain_openai import ChatOpenAI\n\n# Wrap any LLM with safety features\nsafe_llm = ObservareChat(\n llm=ChatOpenAI(model=\"gpt-3.5-turbo\"),\n api_key=\"your-api-key\"\n)\n\n# Apply safety policy\nsafe_llm.apply_policy(SafetyPolicy.BALANCED)\n\n# PII is automatically redacted, hallucinations detected\nresponse = safe_llm.invoke([HumanMessage(content=\"My SSN is 123-45-6789\")])\n# \u2192 \"My SSN is [SSN_REDACTED]\"\n```\n\n## \u2728 Features\n\n### \ud83d\udcca **Zero-Config Telemetry**\n- **Agent lifecycle tracking** - Start, completion, errors\n- **Tool execution monitoring** - Performance and usage\n- **LLM call metrics** - Token usage, costs, latency \n- **Automatic correlation** - Link related events together\n\n### \ud83d\udee1\ufe0f **Enterprise Safety**\n- **PII Redaction** - Emails, phones, SSNs, credit cards\n- **Hallucination Detection** - Multi-method AI safety validation\n- **Configurable Policies** - STRICT, BALANCED, PERMISSIVE\n- **Real-time Monitoring** - Live safety alerts\n\n### \ud83d\udd27 **Production Ready**\n- **Fail-safe operation** - Never breaks your app\n- **High performance** - Minimal latency overhead\n- **Comprehensive logging** - Full audit trails\n- **Easy integration** - Works with existing code\n\n## \u2699\ufe0f Configuration\n\n### Environment Variables\n```bash\nexport OBSERVARE_API_KEY=\"your-api-key\"\n```\n\n### Safety Policies\n```python\n# Maximum security\nsafe_llm.apply_policy(SafetyPolicy.STRICT)\n\n# Balanced (default) \nsafe_llm.apply_policy(SafetyPolicy.BALANCED)\n\n# Minimal restrictions\nsafe_llm.apply_policy(SafetyPolicy.PERMISSIVE)\n```\n\n### Debug Mode\n```python\n# See API errors during development\nhandler = AutoTelemetryHandler(api_key=\"your-key\", debug_mode=True)\n```\n\n## \ud83c\udd98 Support\n\n- **Documentation**: [docs.observare.ai](https://docs.observare.ai)\n- **Issues**: [github.com/observare/sdk/issues](https://github.com/observare/sdk/issues)\n- **Email**: support@observare.ai\n\n## \ud83d\udcc4 License\n\nProprietary - See LICENSE file for details.\n\n---\n\n**Get started in 2 minutes:** Add one line to your LangChain app and gain complete visibility into your AI systems.\n",
"bugtrack_url": null,
"license": "Proprietary",
"summary": "Observability / Telemetry and Safety SDK for LangChain agents with PII redaction and hallucination detection",
"version": "1.0.5",
"project_urls": {
"Documentation": "https://docs.observare.ai",
"Homepage": "https://observare.ai",
"Issues": "https://github.com/observare-ai/observare-sdk/issues",
"Repository": "https://github.com/observare-ai/observare-sdk"
},
"split_keywords": [],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "64348b44ca98d334040b696c9a2b2e922fead5b347f0ff155a4e568a312c994b",
"md5": "f98202c30eeee39bd5f33b2c8f4121bc",
"sha256": "796341df9a8a230a730708d6aa2c2e91c06223fbe9aa45319b59d9798729b302"
},
"downloads": -1,
"filename": "observare_sdk-1.0.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f98202c30eeee39bd5f33b2c8f4121bc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 51179,
"upload_time": "2025-08-07T00:36:53",
"upload_time_iso_8601": "2025-08-07T00:36:53.592328Z",
"url": "https://files.pythonhosted.org/packages/64/34/8b44ca98d334040b696c9a2b2e922fead5b347f0ff155a4e568a312c994b/observare_sdk-1.0.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "1bd6746c0f71a39b90fd05b6fc738dce97102427296d178220de100f808ac894",
"md5": "10dd0e5266c0c6fdae3bb20d0ae9125a",
"sha256": "025572872cdefcfdc22876271ead410fa2c41c317cc933192932721dd3323c35"
},
"downloads": -1,
"filename": "observare_sdk-1.0.5.tar.gz",
"has_sig": false,
"md5_digest": "10dd0e5266c0c6fdae3bb20d0ae9125a",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 50079,
"upload_time": "2025-08-07T00:36:56",
"upload_time_iso_8601": "2025-08-07T00:36:56.463880Z",
"url": "https://files.pythonhosted.org/packages/1b/d6/746c0f71a39b90fd05b6fc738dce97102427296d178220de100f808ac894/observare_sdk-1.0.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-07 00:36:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "observare-ai",
"github_project": "observare-sdk",
"github_not_found": true,
"lcname": "observare-sdk"
}
