Skip to content

Accelerated Text helps you automatically generate multiple natural language descriptions of your data varying in wording and structure.

License

Notifications You must be signed in to change notification settings

emilis/accelerated-text

 
 

Repository files navigation


A picture is worth a thousand words. Or is it? Tables, charts, pictures are all useful in undestanding our data but often we need a description; a story to tell us what are we looking at. Accelerated Text is a natural language generation tool which allows you to define data descriptions and then generates multiple versions of those descriptions varying in wording and structure.


About

Accelerated Text can work with all sorts of data:

  • descriptions of business metrics,
  • metadata describing interactions with the customers,
  • product attributes,
  • financial metrics.

Based on it will generate text to be used in business reports, e-commerce platforms or your customer support system.

Accelerated Text provides a web based Document Plan builder, where

  • the logical structure of the document is defined,
  • communication goals are expresed,
  • data usage within a text is defined.

Document Plans and the connected data are used by Accelerated Text's Natural Language Generation engine to produce multiple variations of the text exactly exactly expressing what was intended to bo communicated to the readers.

Key Features

  • Document plan editor to define what needs to be said about the data.
  • Data samples can be uploaded as CSV files to be used when building Document Plans.
  • Text structure variations to provide richer reading experience going beyond rigid template generated text.
  • Vocabulary control to match the language style of each of your reader groups.
  • In build rule engine to allow the control of what is said based on the different values of the data points.
  • Life preview to see variations of generated text.

Getting Started

Running

Docker

To run Accelerated Text via Docker, just type

docker-compose -p dev -f docker-compose.yml pull && \
        docker-compose -p dev -f docker-compose.yml down && \
        docker-compose -p dev -f docker-compose.yml build && \
        docker-compose -p dev -f docker-compose.yml up --remove-orphans

After running this command the front-end will be availabe at the http://localhost:8080

The generation back-end API is at http://localhost:8081

From Source

If you want to start tinkering and run it based on the latest code in the repository, first make sure that you have the following dependencies installed:

Then clone the project and run

make run-front-end-dev-deps

follwed by

make run-front-end-dev

After running this command the front-end will be availabe at the http://localhost:8080

The generation back-end API is at http://localhost:8081

Usage

Follow the step by step guide bellow to create a very simple document plan which generates book authorship sentences.

View Step
Firstly a new document plan has to be created. The application starts with a Create Plan button in its workspace.
You get an initial empty plan.
You'll need to select a CSV file to provide data for the natural language generation. Select a books.csv file.
The central part of the plan is the Abstract Meaning Representation element which defines the message to be communicated. Select Author from the AMR section.
Then we need to select from where in our book store data we'll have the Author field.
Same for Title field.
That's it, the plan is ready and should look like in the picture to the right.
Text Analysis section shows text variations generated by the natural language generation engine.

Development

To get started with a development environment for Accelerated Text please follow the instructions in our developer's guides for the front-end and the text generation engine.

Getting Help

If you have any questions, do not hesitate asking us at accelerated-text@tokenmill.lt

If you'll submit an Issue this will help everyone and you will be able to track the progress of us fixing it. In order to facilitate it please provide description of needed information for bug requests (like project version number, Docker version, etc.)

License

Copyright © 2019 TokenMill UAB.

Distributed under the The Apache License, Version 2.0.

About

Accelerated Text helps you automatically generate multiple natural language descriptions of your data varying in wording and structure.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 92.2%
  • Clojure 5.4%
  • XSLT 1.0%
  • CSS 1.0%
  • Makefile 0.3%
  • Dockerfile 0.1%