Metadata-Version: 2.4
Name: oubliette-suite
Version: 0.1.0
Summary: The Oubliette Security suite — one install, one CLI for Shield, Dungeon, Trap, and Warden.
Author-email: Oubliette Security <info@oubliettesecurity.com>
License-Expression: Apache-2.0
Project-URL: Homepage, https://oubliettesecurity.com
Project-URL: Repository, https://github.com/oubliettesecurity/oubliette-suite
Keywords: ai-security,llm-firewall,red-team,deception,agentic-security
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Information Technology
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Security
Requires-Python: >=3.11
Description-Content-Type: text/markdown
Requires-Dist: oubliette-shield>=1.0
Requires-Dist: oubliette-dungeon>=1.0
Provides-Extra: full
Requires-Dist: oubliette-trap>=0.2; extra == "full"
Requires-Dist: oubliette-warden>=0.1; extra == "full"
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Provides-Extra: test
Requires-Dist: oubliette-suite[dev]; extra == "test"

# Oubliette

**The Oubliette Security suite — one install, one CLI.**

`oubliette` is the umbrella distribution for the Oubliette Security product suite.
Installing it pulls the core tools and gives you a single `oubliette` command that
dispatches to each.

```bash
pip install oubliette-suite          # core: Shield (firewall) + Dungeon (adversarial engine)
pip install "oubliette-suite[full]"  # + Trap (deception) + Warden (agentic cyber-ops)
```

> The distribution is **`oubliette-suite`** (the bare `oubliette` name is taken on
> PyPI by an unrelated project); the installed import package and CLI are still
> `oubliette`.

## Usage

```bash
oubliette version              # show installed suite components + versions
oubliette dungeon --help       # == oubliette-dungeon --help
oubliette warden --help        # == oubliette-warden --help
```

The CLI shells out to each tool's own console script, so any sub-tool invocation
is identical to calling that tool directly — the umbrella just gives one entry point.

## Components

| Command | Distribution | Role |
|---|---|---|
| `oubliette shield` | `oubliette-shield` | AI firewall — 5-stage detection + deception (library) |
| `oubliette dungeon` | `oubliette-dungeon` | Adversarial testing engine |
| `oubliette trap` | `oubliette-trap` | AI-agent deception platform |
| `oubliette warden` | `oubliette-warden` | Safety-gated agentic cyber-ops |

`oubliette shield` is a library with no CLI; the command explains how to import it.

## Publishing note

`[full]` depends on `oubliette-trap` and `oubliette-warden`. Once all are on PyPI,
`pip install oubliette-suite` (core: shield + dungeon) and `oubliette-suite[full]`
resolve fully.

## Development

```bash
uv venv --python 3.13
uv pip install -e ".[test]"
pytest
```
