# Research workspace

**English** · [Português](README.pt-BR.md)

This directory is for scientific validation only. It is not part of the Acauã
product, is not compiled by Cargo, and is never included in a release artifact.

Use it to generate reproducible fixtures, compare implementations against
reference libraries, and run notebooks for the four detection pillars. The Rust
engine must remain the only runtime used in production.

```bash
cd research
python3 -m venv .venv
. .venv/bin/activate
pip install -e .
jupyter lab
```

The Python environment is isolated from the workspace. Adding a dependency here
does not add it to the shipped binary.