Metadata-Version: 2.4
Name: pymushra
Version: 0.4
Summary: webMUSHRA server in Python
Author-email: Nils Werner <nils.werner@audiolabs-erlangen.de>, Fabian-Robert Stöter <fabian-robert.stoeter@audiolabs-erlangen.de>
License-Expression: MIT
License-File: LICENSE
Requires-Python: >=3.7
Requires-Dist: click
Requires-Dist: flask>=2.2.5
Requires-Dist: ipython
Requires-Dist: matplotlib>=2.0.0
Requires-Dist: numpy
Requires-Dist: pandas
Requires-Dist: patsy
Requires-Dist: scipy
Requires-Dist: seaborn
Requires-Dist: statsmodels
Requires-Dist: tinydb>=3.0.0
Requires-Dist: tinyrecord
Description-Content-Type: text/markdown

pyMUSHRA
========

Description
-----------

pyMUSHRA is a python web application which hosts [webMUSHRA](https://github.com/audiolabs/webMUSHRA) experiments
and collects the data with python.

Quick Start
-----------

You can quickly spin up a pyMUSHRA server [using `uv`](https://docs.astral.sh/uv/guides/tools/) or [`pipx`](https://github.com/pypa/pipx):

    uvx pymushra server -w <path/to/webmushra-sourcedir>
    pipx run pymushra server -w <path/to/webmushra-sourcedir>

or install in a project using

    uv add pymushra
    pip install pymushra

Then open <http://localhost:5000/admin/>

Debugging
---------

You may use the additional tools

    uvx pymushra db

to load and inspect the TinyDB connection and

    uvx pymushra df [collection]

to inspect the Pandas DataFrame export the TinyDB collection.

Server Installation
-------------------

For a long-running pyMUSHRA installation, please do not use the builtin server but instead use a proper
HTTP server, like Apache or Nginx. See [DEPLOYMENT.md](DEPLOYMENT.md) for installation instructions.
