Metadata-Version: 2.4
Name: nthlayer
Version: 1.0.3
Summary: NthLayer ecosystem meta-package — installs all tiers (core, workers, bench, generate).
Author-email: NthLayer <noreply@nthlayer.io>
License: Apache-2.0
Project-URL: Homepage, https://github.com/rsionnach/nthlayer
Project-URL: Documentation, https://github.com/rsionnach/nthlayer
Project-URL: Repository, https://github.com/rsionnach/nthlayer
Project-URL: Changelog, https://github.com/rsionnach/nthlayer/releases
Keywords: sre,reliability,slo,opensrm,observability,prometheus,grafana
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: Apache Software License
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 :: System :: Monitoring
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: nthlayer-core<5,>=4.0.10
Requires-Dist: nthlayer-workers<5,>=4.0.2
Requires-Dist: nthlayer-bench<2,>=1.7.17
Requires-Dist: nthlayer-generate<5,>=4.0.10
Dynamic: license-file

# nthlayer

**NthLayer is an ecosystem of components for AI-augmented operations governance.** This package is a meta-package that installs all four tiers:

- **`nthlayer-core`** (Tier 1) — reliability-critical state, verdicts, assessments, manifests, change-freezes (HTTP API server)
- **`nthlayer-workers`** (Tier 2) — observe / measure / correlate / respond / learn worker modules
- **`nthlayer-bench`** (Tier 3) — operator interface (Textual TUI)
- **`nthlayer-generate`** — manifest compiler and CI/CD generator (specs → Grafana dashboards, Prometheus alerts, SLOs, recording rules, Backstage entities)

## Installation

```bash
pip install nthlayer
```

This installs all four sub-packages at the newest releases within each one's
current major version (core 4.x, workers 4.x, bench 1.x, generate 4.x). A new
major of any tier needs a new meta-package release.

## When to install the meta-package vs. individual components

For most production deployments, install the **specific tier(s) you need** rather than the meta-package:

```bash
pip install nthlayer-core      # Tier 1 only
pip install nthlayer-workers   # Tier 2 only
pip install nthlayer-bench     # Tier 3 only
pip install nthlayer-generate  # Compiler only
```

The meta-package is a friendly entry point for **evaluators, demos, and local development** where you want the full ecosystem available with a single command.

## CLI binaries

Sub-packages provide their own console scripts:

- `nthlayer` / `nthlayer-generate` — compile manifests (from `nthlayer-generate`; the two names are aliases)
- `nthlayer-core serve` — start the Tier 1 HTTP API server (from `nthlayer-core` >= 4.0.0; earlier releases named this script `nthlayer`)
- `nthlayer-workers serve` — start the worker runtime (from `nthlayer-workers`)
- `nthlayer-learn` — verdict-learning CLI (from `nthlayer-workers`)
- `nthlayer-bench` — launch the operator TUI (from `nthlayer-bench`)
- `nthlayer-override-adapter` — override-event sidecar (from `nthlayer-override-adapter`; not a dependency of this meta-package, install it separately)

The meta-package itself contributes no Python modules and no console scripts.

## Documentation

See https://github.com/rsionnach/nthlayer for the project front door, architecture overview, and links to each component repo.

## Licence

Apache 2.0. See [LICENSE](LICENSE).
