A webserver for hosting scorer models.
Project description
[![Build Status](https://travis-ci.org/wikimedia/ores.svg)](https://travis-ci.org/wikimedia/ores) [![Test coverage](https://codecov.io/gh/wikimedia/ores/branch/master/graph/badge.svg)](https://codecov.io/gh/wikimedia/ores)
ORES
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 Redis configuration, you’ll need to install a few more optional libraries,
pip install ores[redis]
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 ores using docker composer
As an easy way to run ores for development, download and install [docker-compose](https://docs.docker.com/compose/) and then do:
docker-compose build && docker-compose up
ores will be accessible through localhost:8080
Running tests
For a native installation, make sure you installed dependencies for testing:
pip install -r test-requirements.txt
then run:
py.test .
For docker installation, run:
docker-compose exec ores-worker py.test /ores
Utilities
ORES provies several utilities: * precached: Starts a daemon that requests scores for revisions as they happen * score_revisions: Scores a set of revisions using an ORES API * stress_test: Scores a large set of revisions at a configurable rate * test_api: Runs a series of tests against a live ORES API
In order to run any of them, run it through ./utility wrapper:
./utility test_api -h
For docker installations run it through one of containers:
docker-compose exec ores-worker /ores/utility test_api -h
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.