Metadata-Version: 2.4
Name: gridseal
Version: 0.4.0
Summary: Verification and compliance-grade audit logging for LLM applications
Project-URL: Homepage, https://gridseal.ai
Project-URL: Documentation, https://docs.gridseal.ai
Project-URL: Repository, https://github.com/gridseal-ai/gridseal
Project-URL: Issues, https://github.com/gridseal-ai/gridseal/issues
Author-email: Celestir LLC <gridseal@celestir.com>
License-Expression: AGPL-3.0-or-later
License-File: LICENSE
Keywords: ai,audit,compliance,hallucination-detection,llm,rag,verification
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or later (AGPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: pydantic>=2.0
Requires-Dist: rich>=13.0
Requires-Dist: scikit-learn>=1.0
Requires-Dist: sentence-transformers>=2.2
Requires-Dist: typer>=0.9
Provides-Extra: all
Requires-Dist: langchain-core>=0.1; extra == 'all'
Requires-Dist: langchain>=0.1; extra == 'all'
Requires-Dist: psycopg2-binary>=2.9; extra == 'all'
Requires-Dist: torch>=2.0; extra == 'all'
Requires-Dist: transformers>=4.30; extra == 'all'
Provides-Extra: dev
Requires-Dist: mypy>=1.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21; extra == 'dev'
Requires-Dist: pytest-cov>=4.0; extra == 'dev'
Requires-Dist: pytest>=7.0; extra == 'dev'
Requires-Dist: ruff>=0.1; extra == 'dev'
Provides-Extra: langchain
Requires-Dist: langchain-core>=0.1; extra == 'langchain'
Requires-Dist: langchain>=0.1; extra == 'langchain'
Provides-Extra: nli
Requires-Dist: torch>=2.0; extra == 'nli'
Requires-Dist: transformers>=4.30; extra == 'nli'
Provides-Extra: postgresql
Requires-Dist: psycopg2-binary>=2.9; extra == 'postgresql'
Description-Content-Type: text/markdown

# GridSeal

[![PyPI version](https://img.shields.io/pypi/v/gridseal.svg)](https://pypi.org/project/gridseal/)
[![Python](https://img.shields.io/pypi/pyversions/gridseal.svg)](https://pypi.org/project/gridseal/)
[![License](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](https://github.com/gridseal-ai/gridseal/blob/main/LICENSE)
[![Downloads](https://img.shields.io/pypi/dm/gridseal.svg)](https://pypi.org/project/gridseal/)

Verification and compliance-grade audit logging for LLM applications.

*A [Celestir](https://celestir.com) product.*

## Installation

```bash
pip install gridseal
```

## Quick Start

```python
from gridseal import GridSeal

gs = GridSeal()

@gs.verify
@gs.audit
def answer(query: str, context: list[str]) -> str:
    return your_llm.generate(query, context)

result = answer("Is this valid?", documents)
print(result.passed)      # True/False
print(result.response)    # The LLM output
print(result.audit_id)    # Audit record ID
```

## Features

- Hallucination detection via grounding checks
- Confidence and relevance scoring
- Citation verification with NLI
- Immutable audit trails with hash chain integrity
- Compliance-grade logging for FedRAMP, NIST AI RMF, EU AI Act

## Configuration

```python
from gridseal import GridSeal

gs = GridSeal(
    verification={
        "checks": ["grounding", "confidence", "relevance"],
        "threshold": 0.7,
        "on_fail": "flag",
    },
    audit={
        "backend": "sqlite",
        "path": "./audit.db",
    },
)
```

## CLI

```bash
gridseal verify --path ./audit.db    # Check integrity
gridseal export --format json        # Export records
gridseal stats                       # Show statistics
```

## License

AGPL-3.0-or-later - See [LICENSE](LICENSE)

## Copyright

Copyright (c) 2026 Celestir LLC
