An essay Analyser & Summariser, using Flask for the API and NLTK for the language processing.
Copyright (c) 2012-2014 Debora Georgia Field <deboraf7 [at] aol.com>
Copyright (c) 2012-2018 Nicolas Van Labeke <nicolas.github [at] calques3d.org>
For the original version of the analyser, see SAFeSEA/pyEssayAnalyser For the current version, see see vanch3d/pyEssayAnalyser
- Clone the project locally on your computer.
- Make sure pip and virtualenv are installed.
- Create a Python virtual environment in the project directory.
The Git repository already ignores a
venvdirectory so why not creating it
$ cd pyEssayAnalyser
$ virtualenv venv
- Activate the virtual environment. On Linux, do the following:
$ . venv/bin/activate
On Windows, the following will work:
$ venv\scripts\activate
- Install the Python requirements.
The project contains a file
stable-req.txtcreated with pip. Use it to install - in the virtual environment - all the packages needed for the system to work.
$ pip install -r stable-req.txt
- Download the NLTK data. NLTK comes with many corpora and trained models, some of which are needed for various aspect of essay analysis. Run the Python interpreter and type the commands:
. >>> import nltk
. >>> nltk.download('all')
Try the NLTK installation:
>>> from nltk.corpus import brown
>>> brown.words()
['The', 'Fulton', 'County', 'Grand', 'Jury', 'said', ...]
- Try the Flask installation and configuration:
$ python src/TestFlask.py
* Running on http://127.0.0.1:5000/
Head over to http://127.0.0.1:5000/ in your browser, you should see the Hello World greetings.
$ python src/pyEssayAnalyser.py
* Running on http://127.0.0.1:5000/
TO DO.
TO DO.
| Method | URL | Action |
|---|---|---|
| GET | / | Hello world |
| POST | /api/essay | add a new essay to the system and return various analytics |
| GET | /api/essay/UID | Retrieve essay with id = UID |
| PUT | /api/essay/UID | Update essay with id = UID |
| GET | /api/essay/UID/analytics | Retrieve various analytics on the essay with id = UID |