This repository contains in-progress research software developed for the CDH project Citing Marx. The primary purpose of this software is to identify quotes of Karl Marx's Manifest der Kommunistischen Partei and the first volume of Das Kapital within articles published in Die Neue Zeit between 1891 and 1918.

Documentation assumes the use of uv for installing python and python packages, as well as running python scripts. The first time you follow these instructions, you should install uv per uv installation documentation. This only step only needs to be done once.

Create a new virtual environment using uv.

uv venv --python 3.12

To install the most recent release published on PyPIi:

uv pip install remarx

remarx as a python package directly from GitHub. Use a branch or tag name, e.g. @develop or @0.1 if you need to install a specific version.

uv pip install "remarx @ git+https://github.com/Princeton-CDH/remarx"

To launch the remarx quote finder application run the remarx-app command:

uv run remarx-app

For convenience, we suggest saving and selecting corpus files from a standard location under your home directory: ~/remarx-data/corpora/original and ~/remarx-data/corpora/reuse. Both the Sentence Corpus Builder and Quote Finder portions of the app default to these folders (with an option to override) and prompt you to create them if they don't exist.

The app will not close automatically when you close the browser window or tab. To close the app:

1. Type control+c within the terminal where the remarx-app command was run
2. Then, when prompted, type y followed by enter.

Find public documentation at: remarx Documentation

For development setup, documentation generation, and contributing guidelines, see Developer Notes.

This project is licensed under the Apache 2.0 License.

(c)2025 Trustees of Princeton University. Permission granted for non-commercial distribution online under a standard Open Source license.