Skip to content

Database for experimental neuroscience laboratories

cortex-lab/alyx

Repository files navigation

alyx

Github Actions Coverage Status

Database for experimental neuroscience laboratories

Documentation

Alyx Experimenter Guide

Installation

The getting started section of the documentation details the steps for

  • installing the Python/Django environment
  • running the app with a development server
  • registering local data
  • accessing local data using ONE

More complex deployments scenarios using web servers and Cloud applications are in the how-to guides section of the documtentaiton

Contribution

  • Development happens on the dev branch
  • alyx is sync with the master branch
  • alyx-dev is sync with the dev branch
  • Migrations files are always provided by the repository

Contribution checklist:

  • lint using ruff ruff check . at the root of the repository
  • tests pass (see below how to run tests)
  • migrations are provided with the commit
  • update version number in ./alyx/alyx/__init__.py
  • update CHANGELOG.md

Running tests

Continuous integration is setup. But before submitting a PR or commit,the tests can run locally. - ./manage.py test -n test without migrations (faster) - ./manage.py test test with migrations (recommended if model changes)

Documentation contribution guide

Dependencies

pip install myst-parser sphinx_rtd_theme sphinx-autobuild

Build documentation locally

From the root of the repository.

sphinx-autobuild -b html ./docs ./docs/_build/ --port 8700

https://www.scan.co.uk/products/3xs-evolve-studio-pro-intel-core-ultra-9-285k-64gb-ddr5-16gb-nvidia-rtx-5070-ti-super-1tb-ssd-2tb-ss