Metadata-Version: 2.0
Name: ores
Version: 1.1.0
Summary: A webserver for hosting scorer models.
Home-page: https://github.com/wiki-ai/ores
Author: Aaron Halfaker
Author-email: ahalfaker@wikimedia.org
License: MIT
Description-Content-Type: UNKNOWN
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Environment :: Other Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Dist: celery (>=3.1.18,<3.1.999)
Requires-Dist: docopt (>=0.6.2,<0.6.999)
Requires-Dist: flask (>=0.10.1,<0.10.999)
Requires-Dist: flask-jsonpify (<1.5.999,>=1.5.0)
Requires-Dist: flask-swaggerui (>=0.0.1,<0.0.999)
Requires-Dist: flask-wikimediaui (>=0.0.1,<0.0.999)
Requires-Dist: mwapi (<0.5.999,>=0.5.0)
Requires-Dist: pytest (<3.2.999,>=3.2.2)
Requires-Dist: pyyaml (==3.11)
Requires-Dist: revscoring (>=2.0.2,<2.0.999)
Requires-Dist: sseclient (>=0.0.18)
Requires-Dist: stopit (>=1.1.1,<1.1.999)
Requires-Dist: yamlconf (>=0.2.2,<0.2.999)

[![Build Status](https://travis-ci.org/wiki-ai/ores.svg)](https://travis-ci.org/wiki-ai/ores)
[![Test coverage](https://codecov.io/gh/wiki-ai/ores/branch/master/graph/badge.svg)](https://codecov.io/gh/wiki-ai/ores)

Objective Revision Evaluation Service
=====================================
A webserver for hosting scoring services. For more information, see [the ORES documentation on MediaWiki](https://mediawiki.org/wiki/ORES).

Installation
============
ORES is based on Python 3. Use pip to install ORES:

``pip install ores`` (or ``pip3 install ores`` if your distribution defaults to Python 2)

If you're running with the default configuration, you'll need to install a few more optional libraries,

``pip install pylru``

Then you can easily run a test server by:

``ores applications.wsgi``

Use the ``-h`` argument to view its usage.

``ores applications.wsgi -h``

Visit these pages to see if your installation works,

``http://localhost:8080/``
``http://localhost:8080/v2/scores/testwiki/revid/641962088?features=true``

Running a development server
============================
We recommend that you set up a python "virtual environment".  We put together
[this guide](https://gist.github.com/halfak/9f4830895496af9e9731) to help you
get everything set up.  

Install requirements AND the test-requirements in order to run the default
test server and experiment with different scoring strategies.

* `$ pip install -r requirements.txt`
* `$ pip install -r test-requirements.txt`

Run a test server as ORES using the `./utility`, so local changes are
reflected: Use `-h` to view its usage

* `$ ./utility applications.wsgi`

Check if everything is running on `http://localhost:8080`.

Authors
=======
* [Aaron Halfaker](https://github.com/halfak)
* [Yuvi Panda](https://github.com/yuvipanda)
* [Amir Sarabadani](https://github.com/Ladsgroup)
* [Justin Du](https://github.com/mdew192837)


