hashtagRR.github.io/AnonTestLab
A local network emulator for testing anonymous communication designs. Relays run as real processes with real handshakes, encryption and sockets, so latency, delivery and attack results are measured rather than modelled.
python3 -m venv .venv && .venv/bin/pip install "anontestlab[dashboard]"
curl -O https://raw.githubusercontent.com/hashtagRR/AnonTestLab/main/examples/tor_like.yaml
.venv/bin/atl run tor_like.yaml # run an example experiment
.venv/bin/atl dashboard # optional web UIThe other example configs are in examples/. Windows, installing from the source code, and troubleshooting: INSTALL.md.
| Guide | What it covers |
|---|---|
| Experiment configs | every YAML option, split policies, crypto, and the four example configs |
| Tools | the atl commands (run, compare, sweep, paired, predict, fidelity, wizard) and the dashboard |
| Adversaries | the five attackers, what each measures, and how to add one |
| Architecture | what happens during a run, and how to extend routing, traffic, crypto or adversaries |
| Known limitations | simplifications to keep in mind when reading results |
| Install guide | platform setup, including Windows |
| Contributing | development setup and how releases are made |
| Changelog | what changed in each version |
| Project site | the project's overview page |
Every release and its changes are in the changelog; each one is archived on Zenodo under the concept DOI above.
v0.5.0: rebuilt dashboard with PDF reports, and a fix to the model's predictions for cover traffic on split legs.v0.4.0(10.5281/zenodo.23211928): the version used for the experiments of a paper on correlation risk in multipath anonymous communication (under review).
AnonTestLab grew out of the test harness of Anon-Sec-Net, a dual-path anonymous communication prototype, and works for other designs too.
GPL-3.0-or-later. See LICENSE.