RiTa: the generative language toolkit

The RiTa website

RiTa is designed to be an easy-to-use toolkit for experiments in natural language and generative literature. It is implemented in Java and JavaScript (with a unified API for both) and optionally integrates with Processing(JS), Android, NodeJS, and Bower. It is free/libre and open-source according to the GPL license (http://www.gnu.org/licenses/gpl.txt).

Please see https://github.com/dhowe/RiTaJS for the JavaScript implementation of RiTa.

About the project

---

• Author: Daniel C. Howe
• Related: RiTaJS
• License: GPL (see included LICENSE file)
• Web Site: https://rednoise.org/rita
• Reference: https://rednoise.org/rita/reference
• Github Repo: https://github.com/dhowe/RiTa/
• Bug Tracker: https://github.com/dhowe/RiTa/issues

 

A Simple Example (Java)

---

1. Create a new Java project in Eclipse (or your IDE of choice)
2. Download rita-latest.jar and add it to the build path for the project. In eclipse: 'Project' > 'Properties' > 'Java Build Path' > 'Libraries' > 'Add External JARs...'
3. Create and run a new class, SimpleExample.java, with the following code:

import rita.*;

public class SimpleExample {

  public static void main(String[] args) {

    RiString rs = new RiString("The elephant took a bite!");
    System.out.println(rs.features());
  }
}

In Processing

---

To install:

1. Open Processing and select 'Sketch' menu > 'Import Library...' > 'Add Library...'
2. Search for 'RiTa' and then install it

Create a simple test sketch as follows (and/or see the included examples):

import rita.*;

println(RiTa.tokenize("The elephant took a bite!"));

In Processing (Android-mode)

---

1. Follow these instructions to setup your environment
2. To add RiTa to your Processing project, select 'Menu' > 'Tools' > 'Import Library' > 'Manage Libraries'
3. Find RiTa inside the 'Library Manager', via 'Menu' > 'Get Libraries' or simply download 'RiTa-latest.zip' then select 'Install Compressed Library' to manually install the zip file.

Create a simple test sketch as follows:

import rita.*;

println(RiTa.tokenize("The elephant took a bite!"));

Can I contribute?

---

Please! We are looking for more coders to help out... Just press Fork at the top of this page and get started, or follow the instructions below...

If you don't feel like coding but still want to contribute, please send a twitter message to @RiTaSoftware.

Development Setup (in Eclipse)

---

1. Download and install Eclipse for Java.

2. In the Eclipse menu, select 'File' > 'Import...'

3. In the 'Import Window' select 'Git' > 'Projects from Git', then press Next.

4. Select 'Clone URI' > then Next and copy and paste the 'HTTPS clone URL' https://github.com/dhowe/RiTa.git from RiTa's Github page into the URI field.

5. Press Next to proceed with the default master branch or (optionally) configure the project directory.

6. Press Next and select 'Import existing projects' to finish.

7. To run the tests:

   a. Navigate to the RiTa/resources directory and right-click on 'build.xml'

   b. Select 'Run as' > 'Ant Build' to compile and run the tests in JUnit.

8. To build the project:

   a. In the Eclipse menu, select 'Window' > 'Show View' -> 'Ant

   b. Click the '+' button to add a buildfile, and navigate to RiTa/resources/build.xml

   c. Click to expand the 'RiTa' menu and reveal the various tasks, then double-click 'build'

   d. When the build is complete, project resources can be found in RiTa/dist

9. Work on an existing issue, then submit a pull request...