In the Margins

How to Run Lexos

Lexos is a web-based tool designed for transforming, analyzing, and visualizing texts. Lexos is designed for use primarily with small to medium-sized text collections, and especially for use with ancient languages and languages that do not employ the Latin alphabet. Lexos was created as an entry-level platform for Humanities scholars and students new to computational techniques while providing tools and techniques sophisticated enough for advanced research.

Lexos runs through your web browser and currently, Lexos supports Google Chrome and Mozilla Firefox; other browsers may not function properly. You my choose of the following methods of running Lexos:

  1. Use the online installation hosted by the Lexomics project at http://lexos.wheatoncollege.edu/. This is very convenient, but you may suffer uploading or processing delays based on fluctuations in internet speed.
  2. Download and Install Lexos using one of the methods provided on the Lexomics website (either use an auto-installer, follow manual instructions, or clone the GitHub repository). This method requires you to install the Python programming language on your computer. Lexos runs in a "localhost" web server on your machine, which may be faster than communicating with the Lexomics server. Running Lexos on your computer also provides the option to to use "local mode", which does not require internet access (see below).

Both methods have their advantages and disadvantages. If you are a beginner, we suggest that you get to know Lexos using the online version. Later, you can download Lexos and run it locally for greater speed.

Using Local Mode

Many functions in Lexos are based on common Javascript libraries like jQuery and Twitter Bootstrap, which are employed all over the internet. So, chances are that your browser has cached these libraries already and doesn't need to load them, which makes loading times much faster. But we can't rely on it. So, even if you are running Lexos on your own computer using localhost, Lexos still requires an active internet connection to download these Javascript libraries. Most of the time, this is not an issue.

But what if you don't have an internet connection? You can still run Lexos locally on your computer. Lexos has all the Javascript libraries built in and will switch to them if you put it in "local mode". All you have to do is find the Lexos folder on your computer and open the file config.cfg in a text editor. Change LOCAL_MODE = False to LOCAL_MODE = True (be careful, it is case sensitive); then save the file. You can ignore the other settings. If you are already running Lexos, quit form it by typing Control+C on the command line and then restart it by typing python lexos.py. (See the Manual Installation instructions on the Lexomics website if you need help with this.) You will now be running in local mode.

This page has paths: