connector-oss

<div align="center">

<br/>

<img src="assets/logo.svg" alt="Connector OSS Logo" width="120" />

<br/>

# 🔐 Connector OSS — Make Every AI Decision Provable

### Your AI agents are making decisions. Can you prove what they did?

*Every AI decision deserves proof. We're building it.*

*Proof = CID content hash + HMAC-chained audit + Ed25519 signatures — verifiable by anyone outside your system.*

**Open-source AI agent framework with tamper-proof memory, cryptographic audit trail, and trust scoring. HIPAA, SOC2, GDPR, EU AI Act evidence-ready. Python, TypeScript, Docker.**

<br/>

[![GitHub stars](https://img.shields.io/github/stars/GlobalSushrut/connector-oss?style=for-the-badge&logo=github&color=yellow)](https://github.com/GlobalSushrut/connector-oss/stargazers)
&nbsp;
[![PyPI](https://img.shields.io/pypi/v/connector-agent-oss?style=for-the-badge&logo=pypi&logoColor=white&color=3b82f6)](https://pypi.org/project/connector-agent-oss/)
&nbsp;
[![npm](https://img.shields.io/npm/v/@connector_oss/connector?style=for-the-badge&logo=npm&color=cb3837)](https://www.npmjs.com/package/@connector_oss/connector)
&nbsp;
[![Docker](https://img.shields.io/badge/docker-ready-2496ED?style=for-the-badge&logo=docker&logoColor=white)](https://hub.docker.com/r/adminumesh3011/connector-oss)

<br/>

[**Get Started**](#-get-started) · [**See It Work**](#-see-it-work) · [**Why Now**](#-why-now) · [**The Gap**](#-the-accountability-gap) · [**vs Others**](#-connector-vs-everything-else) · [**Docs**](docs/01_INDEX.md)

</div>

---

## 🚀 Get Started

```bash
pip install connector-agent-oss
```

```python
from connector_agent_oss import Connector
import os

c = Connector("deepseek", "deepseek-chat", os.environ["DEEPSEEK_API_KEY"])
result = c.agent("bot", "You are helpful").run("Hello!", "user:alice")
```

That's it. **3 lines.** Every response now includes:

- **`result.cid`** — tamper-proof content hash (CIDv1, SHA2-256)
- **`result.trust`** — kernel-verified trust score, 0–100
- **`result.audi