Skip to main content tracks up to 100 unmarked animals from videos recorded in laboratory conditions using artificial intelligence. Free and open source.

Project description

image pipeline Documentation Status Supported Python versions PyPI downloads Licence Nature Paper

Find everything you are looking for in our website is a multi-animal tracking software for laboratory conditions. This work has been published in Nature Methods (pdf here)

Installation for developers.

On an environment with Python 3.10, 3.11 or 3.12 and a working installation of Pytorch (Torch and Torchvision) you can install the latest published version by installing directly form the GitLab repo:

pip install git+

Or install the developing version from the develop branch (currently v5-dev):

pip install git+

There exist two extra dependencies options:

  • dev to install tools for formatting, static analysis, building, publishing, etc.
  • docs to install needed packages to build documentation (sphinx and some plugins).


  • Jordi Torrents (2022-)
  • Antonio Ortega (2021-2023)
  • Francisco Romero-Ferrero (2015-2022)
  • Mattia G. Bergomi (2015-2018)
  • Ricardo Ribeiro (2018-2020)
  • Francisco J.H. Heras (2015-2022)

All present files here are part of, a project described in:

Romero-Ferrero, F., Bergomi, M.G., Hinz, R.C., Heras, F.J.H., de Polavieja, G.G., Nature Methods, 2019. tracking all individuals in small or large collectives of unmarked animals.

Copyright (C) 2017- Francisco Romero Ferrero, Mattia G. Bergomi, Francisco J.H. Heras, Robert Hinz, Gonzalo G. de Polavieja and the Champalimaud Foundation. is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. In addition, we require derivatives or applications to acknowledge the authors.

You should have received a copy of the GNU General Public License along with this program. If not, see

For more information please send an email ( or use the tools available at

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.

Source Distribution

idtrackerai-5.2.12.tar.gz (6.2 MB view hashes)

Uploaded Source

Built Distribution

idtrackerai-5.2.12-py3-none-any.whl (6.3 MB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page