remarx 1.0.2

Code for identifying Marx quotes associated with the CDH project Citing Marx

remarx

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.

[!WARNING] A bug in versions prior to 1.0.2 means that quotation candidates generated with multiple original files selected are not reliable. We recommend upgrading to v1.0.2 and regenerating any data based on multiple original files.

Basic Usage

Installation

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 uv environment

Create a new virtual environment using uv.

uv venv --python 3.12

Install remarx

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"

Launch quote finder app

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

uv run remarx-app

Default corpus directories

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.

Closing quote finder app

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.

Documentation

Find public documentation at: remarx Documentation

Development

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

License

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.