Research software

The local Histsearch project

The public collection is a curated export. The Python application runs on its operator’s computer and produces research packets, records, and search logs.

For an existing Histsearch source checkout, use its README and Python package to create an isolated environment. The following commands are for the local project, not the website repository.

python3.12 -m venv .venv
.venv/bin/python -m pip install -e '.[dev]'
.venv/bin/histsearch init
.venv/bin/histsearch app

The app stores private working data locally. Public dossiers are selected, reviewed, and exported separately; running a search does not publish its results.

Stop the local application with .venv/bin/histsearch stop. Use .venv/bin/histsearch doctor to inspect connector availability.

Return to the curated collection →