Metadata-Version: 2.4
Name: clinicalguard
Version: 1.0.1
Summary: Constitutional AI governance for clinical decision support — Agents Assemble hackathon
Author-email: ACGS Team <hello@acgs.dev>
License-Expression: AGPL-3.0-or-later
Project-URL: Homepage, https://acgs.ai
Project-URL: Documentation, https://github.com/dislovelhl/clinicalguard
Project-URL: Repository, https://github.com/dislovelhl/clinicalguard
Project-URL: Issues, https://github.com/dislovelhl/clinicalguard/issues
Project-URL: Changelog, https://github.com/dislovelhl/clinicalguard/releases
Project-URL: PyPI, https://pypi.org/project/clinicalguard/
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: acgs-lite>=2.5
Requires-Dist: starlette>=0.37
Requires-Dist: uvicorn[standard]>=0.29
Requires-Dist: pyyaml>=6.0
Requires-Dist: httpx>=0.27
Requires-Dist: pydantic>=2.0
Provides-Extra: anthropic
Requires-Dist: anthropic>=0.30; extra == "anthropic"
Provides-Extra: openai
Requires-Dist: openai>=1.0; extra == "openai"
Provides-Extra: all
Requires-Dist: clinicalguard[anthropic,openai]; extra == "all"
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
Requires-Dist: pytest-cov; extra == "dev"
Requires-Dist: httpx; extra == "dev"

# clinicalguard

[![PyPI](https://img.shields.io/pypi/v/clinicalguard)](https://pypi.org/project/clinicalguard/)
[![Python](https://img.shields.io/pypi/pyversions/clinicalguard)](https://pypi.org/project/clinicalguard/)
[![License: AGPL-3.0](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)

**Constitutional AI governance for healthcare agents.**

`clinicalguard` is a Starlette-based A2A service for validating proposed clinical
actions against a healthcare constitution. It combines deterministic ACGS validation,
healthcare-specific validators, JSON-RPC 2.0 endpoints, and audit-trail persistence.

## Installation

`clinicalguard` supports Python 3.11+.

```bash
pip install acgs-lite clinicalguard
pip install clinicalguard[anthropic]
pip install clinicalguard[openai]
```

`clinicalguard` currently relies on `acgs-lite` at runtime; install it alongside the
package when working from PyPI or source checkouts.

## Quick Start

### Run the Service

```bash
uvicorn clinicalguard.main:app --host 0.0.0.0 --port 8080
```

### Validate a Clinical Action

```bash
curl -X POST http://localhost:8080/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tasks/send",
    "params": {
      "id": "task-001",
      "message": {
        "parts": [{
          "text": "validate_clinical_action: Patient SYNTH-042 on Warfarin. Propose Aspirin 325mg daily."
        }]
      }
    }
  }'
```

### Build the App in Python

```python
from clinicalguard.agent import ClinicalGuardApp

guard = ClinicalGuardApp.create(
    constitution_path="constitution/healthcare_v1.yaml",
    audit_log_path="audit.jsonl",
)
app = guard.build_starlette_app()
```

## Key Features

- Healthcare-focused constitutional validation with MACI-style self-approval blocking.
- A2A skills for clinical validation, HIPAA checks, and audit-trail queries.
- Starlette service surface with agent-card, health, and JSON-RPC endpoints.
- Audit-log persistence and restoration for forensic review.
- Optional Anthropic and OpenAI reasoning layers on top of deterministic checks.

## Configuration

| Variable | Default | Purpose |
| --- | --- | --- |
| `CLINICALGUARD_API_KEY` | unset | Optional `X-API-Key` protection for request handling |
| `CLINICALGUARD_URL` | unset | Optional published service URL for agent-card metadata |

## License

AGPL-3.0-or-later. Commercial licensing is available; contact `hello@acgs.ai`.

## Links

- [Homepage](https://acgs.ai)
- [Documentation](https://github.com/dislovelhl/acgs/tree/main/packages/clinicalguard)
- [PyPI](https://pypi.org/project/clinicalguard/)
- [Repository](https://github.com/dislovelhl/acgs)
- [Issues](https://github.com/dislovelhl/acgs/issues)
- [Changelog](https://github.com/dislovelhl/acgs/releases)

Constitutional Hash: `608508a9bd224290`
