Metadata-Version: 2.4
Name: docoreai
Version: 2.0.0
Summary: Privacy-first LLM observability and budget control — full AI cost visibility with zero prompt storage.
Home-page: https://docoreai.com
Author: Saji John Miranda
Author-email: saji.john@docoreai.com
License: CC BY-NC-ND 4.0
Project-URL: Homepage, https://docoreai.com
Project-URL: Documentation, https://docoreai.com/docs/
Project-URL: Blog Post, https://mobilights.medium.com/intelligent-prompt-optimization-bac89b64fa84
Project-URL: Funding, https://docoreai.com/pricing/
Project-URL: Support, https://docoreai.com/contact-us
Keywords: llm observability,ai cost control,llm budget management,privacy-first ai,zero prompt storage,ai governance,token tracking,llmops,ai observability,budget pacing,enterprise ai,llm monitoring,prompt monitoring,anthropic,openai,groq,google gemini,ollama,llm cost reduction,ai spending,docoreai
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Classifier: License :: Other/Proprietary License
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Intended Audience :: Information Technology
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: System :: Monitoring
Classifier: Topic :: System :: Logging
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: uvicorn
Requires-Dist: pydantic
Requires-Dist: fastapi
Requires-Dist: python-dotenv
Requires-Dist: openai
Requires-Dist: groq
Requires-Dist: requests
Requires-Dist: tiktoken
Requires-Dist: platformdirs
Requires-Dist: lightgbm
Requires-Dist: PySide6
Requires-Dist: wrapt
Requires-Dist: pyqtgraph
Requires-Dist: typer
Requires-Dist: rich
Requires-Dist: click
Requires-Dist: setuptools>=40.0.0
Requires-Dist: psutil>=5.9.0
Requires-Dist: importlib-metadata; python_version < "3.8"
Requires-Dist: packaging>=20.0
Requires-Dist: streamlit
Requires-Dist: pandas
Requires-Dist: streamlit-aggrid
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

![DoCoreAI Banner](https://docoreai.com/wp-content/uploads/2026/06/DoCoreAI-Pypi-1.png)

# DoCoreAI — Privacy-First AI Observability & Budget Control

### Full LLM Cost Visibility · Zero Prompt Storage · Autonomous Budget Management

---

[![🔥 Downloads](https://static.pepy.tech/badge/docoreai)](https://pepy.tech/project/docoreai)
![📦 Version](https://img.shields.io/pypi/v/docoreai)
![🐍 Python](https://img.shields.io/pypi/pyversions/docoreai)
[![🧾 License](https://img.shields.io/badge/license-CC%20BY--NC--ND%204.0-blue)](https://creativecommons.org/licenses/by-nc-nd/4.0/)

---

## What is DoCoreAI?

DoCoreAI is a **privacy-first AI observability and budget control platform** for enterprise teams running LLM-powered applications.

Most observability tools require logging prompts and conversations — making them incompatible with enterprise security and compliance policies. DoCoreAI solves this by using **metadata-only telemetry**: it captures cost, tokens, latency, and model behaviour **without ever storing a prompt**.

> **Privacy by architecture. Not by policy.**

---

## 🎯 Who It's For

| Role | What DoCoreAI Solves |
|------|----------------------|
| **CTOs & VPs Engineering** | Stop AI budget surprises. Full spend visibility across every team. |
| **AI Platform Teams** | Monitor multi-LLM deployments without compliance risk. |
| **Enterprise Security Teams** | Observability that your security team will actually approve. |
| **Developers** | Drop-in SDK. Live cost data in under 15 minutes. No infrastructure changes. |

---

## 🚀 Quick Start

```bash
pip install docoreai
```

> ⏱️ Average integration time: **under 15 minutes**.

Get your free token at **[docoreai.com/account-settings](https://docoreai.com/account-settings)**

Configure your `.env` file:

```ini
DOCOREAI_TOKEN=your_token_here
DOCOREAI_API_URL=https://docoreai.com
MODEL_PROVIDER=openai
MODEL_NAME=gpt-3.5-turbo
OPENAI_API_KEY=your_key_here
ALLOW_SYSTEM_MESSAGE_INJECTION=true
```

Start the sidecar engine:

```bash
docoreai start
```

Verify the setup:

```bash
docoreai test
```

View your cost dashboard:

```bash
docoreai dash
```

---

## 🐍 How Integration Works

DoCoreAI runs as a **sidecar process** alongside your application. It automatically intercepts and instruments all LLM API calls — no code changes required in your existing application.

```bash
# Terminal 1 — start the DoCoreAI sidecar
docoreai start

# Terminal 2 — run your application as normal
python your_app.py
# All LLM calls are captured automatically
```

The sidecar captures **only metadata** — cost, tokens, latency, model name, and timing — and sends it to the DoCoreAI cloud engine. **Prompts and responses never leave your environment.**

---

## ✅ Core Features

### 🔒 Privacy-First Observability
- **Zero prompt storage** — metadata-only telemetry by architecture
- **Local-side instrumentation** — the sidecar runs inside your environment
- **PII detection at the edge** — sensitive data never leaves your network
- **SOC2-aligned telemetry** — structured audit trails with no prompt exposure

### 💰 Intelligent Budget Control
- **Autonomous pacing engine** — prevents budget overruns proactively
- **Soft limits per team, application, and model** — configurable governance
- **30-day predictive model** — learns spending patterns, allocates budget intelligently
- **Auto-retrain triggers** — model adapts as usage patterns evolve *(coming soon)*

### 📊 Real-Time Cost Intelligence
- **Per-request cost tracking** — every LLM call measured and attributed
- **By team, feature & model** — granular breakdown across your organisation
- **Token waste detection** — identify bloated prompts and agent loop inefficiencies
- **A/B model comparison** — compare cost vs quality across providers
- **Drift detection** — catch unexpected model behaviour changes early

### 🔌 Multi-LLM Support
Works with **OpenAI, Anthropic, Google Gemini, Groq, Ollama, and llama.cpp** — covering both cloud and local/on-premise deployments.

---

## 🏗️ How It Works

```
Your App    →    SDK (Local)        →    Cloud Engine    →    Dashboard
                 ─────────────           ─────────────        ─────────
Any LLM call     Extracts metadata       Aggregates           Full cost
                 Cost, tokens,           metrics              visibility
                 latency, model          No prompts
                 No prompts stored       ever transmitted
```

The DoCoreAI SDK intercepts LLM calls at the library level using an automatic instrumentation layer. Only structured metadata is forwarded to the DoCoreAI server. **Prompts and responses are never transmitted or stored — by architecture.**

---

## 🖥️ CLI Reference

```bash
docoreai start    # Launch the sidecar engine (captures all LLM calls)
docoreai test     # Run a test prompt to verify setup
docoreai show     # Open local Streamlit metrics viewer (client-side data)
docoreai dash     # Open cloud dashboard in browser
```

---

## ⚙️ Full Configuration

```ini
# .env

DOCOREAI_TOKEN=                         # Get from docoreai.com/account-settings
DOCOREAI_API_URL=https://docoreai.com   # Cloud endpoint
ALLOW_SYSTEM_MESSAGE_INJECTION=true     # Enables automatic LLM instrumentation

# LLM Providers — add whichever you use
OPENAI_API_KEY=
GROQ_API_KEY=
ANTHROPIC_API_KEY=
GOOGLE_API_KEY=

MODEL_PROVIDER=openai                   # openai | groq | anthropic | google | ollama
MODEL_NAME=gpt-3.5-turbo
```

---

## 📊 Dashboard

View your AI cost intelligence at **[docoreai.com/dashboard](https://docoreai.com/dashboard)**

Available metrics include:

- Budget vs Spend
- Cost by Project & Team
- Token Waste per Prompt
- Model Performance & Drift
- API Usage by Hour
- Prompt Success Rate
- ROI: Cost vs Time
- Response Efficiency

---

## ✅ Quick Start Checklist

- [x] `pip install docoreai`
- [x] Get your token at [docoreai.com/account-settings](https://docoreai.com/account-settings)
- [x] Create `.env` with your API keys and DoCoreAI token
- [x] Run `docoreai start`
- [x] Run `docoreai test` to verify
- [x] Open `docoreai dash` to view live cost data

---

## 📘 Resources

- 🌐 [Official Website](https://docoreai.com)
- 📖 [Documentation](https://docs.docoreai.com)
- 📊 [Dashboard](https://docoreai.com/dashboard)
- 💰 [Pricing](https://docoreai.com/pricing/)
- 📝 [Blog](https://mobilights.medium.com/25-days-of-docoreai-a-reflection-on-the-journey-so-far-f832c1210996)
- 💬 [Support](https://docoreai.com/contact-us)

---

## 📜 License

Licensed under [CC BY-NC-ND 4.0](https://creativecommons.org/licenses/by-nc-nd/4.0/)

For commercial or enterprise licensing: **saji@docoreai.com**

---

> Built for enterprise teams that cannot afford to choose between privacy and visibility.
> **DoCoreAI gives you both.**
