Skip to content

jakub-jedrusiak/VelesResearch

Repository files navigation

Veles logo, text Veles with Veles' rune instead of V.


PyPI GitHub codecov

Veles is a free and open source Python research package, primarly for social scientists. It's goal is to provide an interface for surveys and chronometric experiments. It combines the power of Survey.js and PsychoJS (PsychoPy) with Python interface to create self contained research units that can be self-hosted. Veles' own web service for creating and hosting experiments are planned.

Veles is in pre-alpha development, but the goal features are:

  • Free and open source.

  • Text-based, so automatable and easily modifiable.

  • Ability to use JavaScript and CSS directly.

  • Open source documentation.

  • reCAPTCHA v3 protection from bots by default.

  • Detection of pasted answers and writing speed calculation (detect GPT).

  • Integration with GitHub.

  • Python-based.

  • Esay to collaborate through git.

  • Custom redirection in the end (for panels).

  • PsychoPy integration.

  • Modifiable themes.

Installation

You can install the current version of Veles with:

pip install velesresearch

You can install development version (unstable) with:

pip install velesresearch@git+https://github.com/jakub-jedrusiak/VelesResearch.git

Note that bun is required for Veles to work. Use one of the following commands to install it:

# Linux and MacOS
curl -fsSL https://bun.sh/install | bash

# Windows
powershell -c "irm bun.sh/install.ps1|iex"

If everything went well, command bun --version should return a version number. See Getting started if you get any errors.