Metadata-Version: 2.4
Name: roguard-child-safety
Version: 4.0.0
Summary: Offline Romanian and Ukrainian child-safety contract and evaluation toolkit
Author: RoGuard contributors
License-Expression: MIT
Project-URL: Homepage, https://github.com/xyz-rafael-xyz/roguard-child-safety
Project-URL: Repository, https://github.com/xyz-rafael-xyz/roguard-child-safety
Project-URL: Documentation, https://github.com/xyz-rafael-xyz/roguard-child-safety/blob/main/README.md
Project-URL: Issues, https://github.com/xyz-rafael-xyz/roguard-child-safety/issues
Keywords: child-safety,Romanian,Ukrainian,evaluation,guardrails
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: semantic
Requires-Dist: torch<3,>=2.6; extra == "semantic"
Requires-Dist: transformers<5,>=4.57; extra == "semantic"
Requires-Dist: numpy<3,>=1.26; extra == "semantic"
Provides-Extra: train
Requires-Dist: numpy>=1.26; extra == "train"
Requires-Dist: pyyaml>=6; extra == "train"
Requires-Dist: torch>=2.3; extra == "train"
Requires-Dist: transformers<5,>=4.46; extra == "train"
Requires-Dist: peft<1,>=0.13; extra == "train"
Requires-Dist: accelerate<2,>=1; extra == "train"
Provides-Extra: mlx
Requires-Dist: mlx-lm<0.32,>=0.31.3; extra == "mlx"
Provides-Extra: test
Requires-Dist: pytest>=8; extra == "test"
Requires-Dist: jsonschema<5,>=4.23; extra == "test"
Provides-Extra: message-train
Requires-Dist: numpy<3,>=1.26; extra == "message-train"
Requires-Dist: scikit-learn<2,>=1.5; extra == "message-train"
Dynamic: license-file

# RoGuard

RoGuard is an offline Romanian and Ukrainian child-safety research toolkit. Version 4 adds a local conversation workspace, optional semantic classification, explicit uncertainty, draft-response checks and a separate audit of declared routing, permission and human-review requirements. Reports reference relevant turns without copying message text. The software never contacts a guardian or takes an external action.

## Install and open

```sh
pip install --upgrade roguard-child-safety
roguard-studio --conversation --open
```

The basic package supports Python 3.9–3.14 and includes a small fast model. The stronger semantic backend uses optional dependencies and a one-time, explicit model download:

```sh
pip install --upgrade 'roguard-child-safety[semantic]'
roguard-model fetch
roguard-studio --conversation --open --backend semantic
```

Use Python 3.10+ for the optional backend; the semantic test environment is Python 3.12. After downloading the pinned base, inference is local and requires no network. The Python import is `roguard`. The `roguard-conversation` command supports JSON and batches; `roguard-compare-reports` compares matching case IDs.

The semantic model reached 96.7% Romanian and 96.2% Ukrainian balanced accuracy on a 200-conversation synthetic test. This test contains only 20 phrase families per language and has correlated rows. The fast model is weaker. Neither result establishes accuracy on authentic child language; a negative signal cannot close a concern. Scores are not safety probabilities, response checks are limited phrase rules, and complexity measures do not prove comprehension. Prior specialist taxonomy review does not validate the new models or message banks.

See the [workspace guide](https://github.com/xyz-rafael-xyz/roguard-child-safety/blob/main/docs/CONVERSATION_WORKSPACE.md), [full results](https://github.com/xyz-rafael-xyz/roguard-child-safety/blob/main/docs/V4_RELEASE.md), and [README](https://github.com/xyz-rafael-xyz/roguard-child-safety/blob/main/README.md). Report defects through [GitHub Issues](https://github.com/xyz-rafael-xyz/roguard-child-safety/issues).
