The Ubiquitous Larch
Get Ubiquitous Larch

Download ZIP

Download arrow DOWNLOAD

Contains Python source code; can be executed as is with a Python interpreter

Latest version: 0.3-alpha

  • First open source release

All releases



License

The Ubiquitous Larch is licensed for use under the GNU Affero General Public License version 3.


Install Python 2.7

If you don't already have Python installed on your machine (it comes installed on most MacOS and Linux machines), please see the Install Python for Ubiquitous Larch page for more information.


Optional libraries

Some optional Python libraries may be helpful:

  • markdown: if markdown is present, Larch will import IPython notebook markdown cells correctly

Collaborative use on a public server

In order to use the real-time collaborative features of Ubiquitous Larch, it must be run on a publicly accessible server. Please see the Collaborative Ubiquitous Larch page for more information. Please note that there are certain security precautions that one must take if attempting to run Ubiquitous Larch on a public server; they are explained on the aforementioned page.


Mercurial Repo

You can find the Ubiquitous Larch Mercurial repo here.

Documentation

The Ubiquitous Larch comes with built-in documentation; it is available through a link at the top of any Ubiquitous Larch page.


Getting started (single user on a desktop machine)

Running with Standard Python

From a file explorer Window (e.g. Windows or MacOS)
  1. Open the directory into which you unzipped Ubiquitous Larch.
  2. Find the file start_ularch.py.
  3. Open/run it.
  4. Your browser will open the Ubiquitous Larch front page (if it doesn't open it and enter the address http://127.0.0.1:5000).
From the command line
  1. Open a shell (Command Prompt on Windows).
  2. Change to the directory into which you unzipped Ubiquitous Larch.
  3. Type:
    python start_ularch.py

Running with Enthought Canopy Python distribution

Windows
  1. Start an Enthought Canopy command prompt.
  2. Change to the directory into which you unzipped Ubiquitous Larch.
  3. Type:
    python start_ularch.py
MacOS and Linux

I do not have experience with these systems. You will need to open a command shell with Enthought Python available at the system path. Within your shell, change to the directory in which you unzipped Ubiquitous Larch, then type:

python start_ularch.py