Metadata-Version: 2.5
Name: simpleaudit-studio
Version: 0.5.9
Summary: Production AI model audit platform — one-liner demo mode via uvx
License: MIT
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: caddyserver>=2.11.7
Requires-Dist: cronsim==2.7
Requires-Dist: django==5.2.4
Requires-Dist: djangorestframework==3.16.0
Requires-Dist: drf-spectacular==0.28.0
Requires-Dist: hatchet-sdk==1.41.0
Requires-Dist: httpx>=0.27
Requires-Dist: opentelemetry-proto>=1.45.0
Requires-Dist: psutil>=7.2.2
Requires-Dist: pydantic<3,>=2.7
Requires-Dist: python-dotenv==1.1.1
Requires-Dist: requests==2.32.5
Requires-Dist: sentry-sdk[django]>=2.0
Requires-Dist: simpleaudit==0.3.2
Requires-Dist: workos==10.4.0
Provides-Extra: dev
Requires-Dist: factory-boy==3.3.2; extra == 'dev'
Requires-Dist: pytest-django<5,>=4.8; extra == 'dev'
Requires-Dist: pytest-env<2,>=1; extra == 'dev'
Requires-Dist: pytest-testmon<3,>=2; extra == 'dev'
Requires-Dist: pytest-xdist<3.8,>=3.6; extra == 'dev'
Requires-Dist: pytest<9,>=8; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Provides-Extra: e2e
Requires-Dist: playwright>=1.45; extra == 'e2e'
Provides-Extra: postgres
Requires-Dist: psycopg[binary]==3.2.13; extra == 'postgres'
Provides-Extra: server
Requires-Dist: gunicorn==23.0.0; extra == 'server'
Description-Content-Type: text/markdown

---
title: SimpleAudit Studio
emoji: 🔍
colorFrom: blue
colorTo: indigo
sdk: docker
app_port: 7860
pinned: false
---

# SimpleAudit Studio

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
[![Python](https://img.shields.io/badge/Python-3.11%2B-blue.svg)](https://www.python.org/)
[![PyPI](https://img.shields.io/pypi/v/simpleaudit-studio)](https://pypi.org/project/simpleaudit-studio/)

A self-hostable platform for reproducible AI model audits using the [SimpleAudit](https://github.com/SimulaMet/simpleaudit) engine.

## Quick run

Needs [uv](https://docs.astral.sh/uv/):

```bash
uvx simpleaudit-studio@latest
```

To run the latest code from GitHub instead of the published package:

```bash
uvx --from "git+https://github.com/SimulaMet/SimpleAuditStudio@main" spin
```

Open <http://localhost:8000>. Try the [live demo](https://sushantgautam-simpleaudit-studio.hf.space) if you do not want to install anything.

## Development

```bash
git clone https://github.com/SimulaMet/SimpleAuditStudio
cd SimpleAuditStudio
cp .env.dev.example .env
uv sync --extra dev
uv run manage.py setup_local
uv run manage.py dev
```

The app opens at <http://localhost:8000> with live reload. Use `--no-browser` to skip opening a browser.

## What it does

- Build versioned scenario sets and register OpenAI-compatible models.
- Define judges and run audits across models, scenarios, and settings.
- Review runs live and compare results in the dashboard.
- Monitor models for drift on a schedule.

## Documentation

- [Deployment](docs/deployment.md) — all run commands, settings, chat, upgrades, backups, and production notes
- [Chat](docs/chat.md) — chat setup and privacy details
- [Architecture](docs/architecture.md) — system design and service boundaries
- [Domain model](docs/domain-model.md) — core data and invariants

## Contributing

Architecture decisions are documented in [docs/architecture.md](docs/architecture.md).
