{"id":14986149,"url":"https://github.com/vida-nyu/reprozip","last_synced_at":"2025-04-10T06:18:51.519Z","repository":{"id":16742679,"uuid":"19500159","full_name":"VIDA-NYU/reprozip","owner":"VIDA-NYU","description":"ReproZip is a tool that simplifies the process of creating reproducible experiments from command-line executions, a frequently-used common denominator in computational science.","archived":false,"fork":false,"pushed_at":"2024-12-02T21:45:06.000Z","size":20808,"stargazers_count":312,"open_issues_count":77,"forks_count":35,"subscribers_count":17,"default_branch":"1.x","last_synced_at":"2025-04-03T04:07:48.117Z","etag":null,"topics":["archiving","computational-science","docker","hacktoberfest","linux","nyu","ptrace","python","reproducibility","reproducible-research","reproducible-science","reprounzip","reprozip","science","scientific-computing","vagrant"],"latest_commit_sha":null,"homepage":"https://www.reprozip.org/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/VIDA-NYU.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-05-06T15:42:09.000Z","updated_at":"2025-03-13T17:33:01.000Z","dependencies_parsed_at":"2023-02-19T14:45:57.002Z","dependency_job_id":"824351f6-2ea2-41aa-9a5c-c00ed0812382","html_url":"https://github.com/VIDA-NYU/reprozip","commit_stats":{"total_commits":2173,"total_committers":18,"mean_commits":"120.72222222222223","dds":"0.16658996778647028","last_synced_commit":"3015ced421378a9b03ab87a749136bde867196a4"},"previous_names":[],"tags_count":38,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VIDA-NYU%2Freprozip","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VIDA-NYU%2Freprozip/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VIDA-NYU%2Freprozip/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/VIDA-NYU%2Freprozip/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/VIDA-NYU","download_url":"https://codeload.github.com/VIDA-NYU/reprozip/tar.gz/refs/heads/1.x","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248166864,"owners_count":21058481,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["archiving","computational-science","docker","hacktoberfest","linux","nyu","ptrace","python","reproducibility","reproducible-research","reproducible-science","reprounzip","reprozip","science","scientific-computing","vagrant"],"created_at":"2024-09-24T14:12:25.798Z","updated_at":"2025-04-10T06:18:51.482Z","avatar_url":"https://github.com/VIDA-NYU.png","language":"Python","readme":"[![Build Status](https://github.com/VIDA-NYU/reprozip/workflows/Test/badge.svg)](https://github.com/VIDA-NYU/reprozip/actions)\n[![Coverage Status](https://codecov.io/github/VIDA-NYU/reprozip/coverage.svg?branch=1.x)](https://codecov.io/github/VIDA-NYU/reprozip?branch=1.x)\n[![Documentation Status](https://readthedocs.org/projects/reprozip/badge/?version=1.x)](https://docs.reprozip.org/en/1.x/)\n[![Matrix](https://img.shields.io/badge/chat-matrix.org-blue.svg)](https://riot.im/app/#/room/#reprozip:matrix.org)\n[![paper](https://img.shields.io/badge/JOSS-10.21105%2Fjoss.00107-green.svg)](http://joss.theoj.org/papers/b578b171263c73f64dfb9d040ca80fe0)\n[![DOI](https://img.shields.io/badge/DOI-10.5281%2Fzenodo.10291844-green.svg)](https://doi.org/10.5281/zenodo.10291844)\n\nReproZip\n========\n\n[ReproZip][web] is a tool aimed at simplifying the process of creating reproducible experiments from command-line executions, a frequently-used common denominator in computational science.\n\nIt tracks operating system calls and creates a package that contains all the binaries, files and dependencies required to run a given command on the author's computational environment (packing step). A reviewer can then extract the experiment in his environment to reproduce the results (unpacking step).\n\nQuickstart\n----------\n\nWe have an [example repository](https://github.com/VIDA-NYU/reprozip-examples) with a variety of different software. Don't hesitate to check it out, and contribute your own example if use ReproZip for something new!\n\n### Packing\n\nPacking experiments is only available for Linux distributions. In the environment where the experiment is originally executed, first install reprozip:\n\n    $ pip install reprozip\n\nThen, run your experiment with reprozip. Suppose you execute your experiment by originally running the following command:\n\n    $ ./myexperiment -my --options inputs/somefile.csv other_file_here.bin\n\nTo run it with reprozip, you just need to use the prefix *reprozip trace*:\n\n    $ reprozip trace ./myexperiment -my --options inputs/somefile.csv other_file_here.bin\n\nThis command creates a *.reprozip-trace* directory, in which you'll find the configuration file, named *config.yml*. You can edit the command line and environment variables, and choose which files to pack.\n\nIf you are using Debian or Ubuntu, most of these files (library dependencies) are organized by package. You can add or remove files, or choose not to include a package by changing option *packfiles* from true to false. In this way, smaller packs can be created with reprozip (if space is an issue), and reprounzip can download these files from the package manager; however, note this is only available for Debian and Ubuntu for now, and also be aware that package versions might differ. Choosing which files to pack is also important to remove sensitive information and third-party software that is not open source and should not be distributed.\n\nOnce done editing the configuration file (or even if you did not change anything), run the following command to create a ReproZip package named *my_experiment*:\n\n    $ reprozip pack my_experiment.rpz\n\nVoil\u0026agrave;! Now your experiment has been packed, and you can send it to your collaborators, reviewers, and researchers around the world!\n\nNote that you can open the help message for any reprozip command by using the flag *-h*.\n\n### Unpacking\n\nDo you need to unpack an experiment in a Linux machine? Easy! First, install reprounzip:\n\n    $ pip install reprounzip\n\nThen, if you want to unpack everything in a single directory named *mydirectory* and execute the experiment from there, use the prefix *reprounzip directory*:\n\n    $ reprounzip directory setup my_experiment.rpz mydirectory\n    $ reprounzip directory run mydirectory\n\nIn case you prefer to build a chroot environment under *mychroot*, use the prefix *reprounzip chroot*:\n\n    $ reprounzip chroot setup my_experiment.rpz mychroot\n    $ reprounzip chroot run mychroot\n\nNote that the previous options do not interfere with the original configuration of the environment, so don't worry! If you are using Debian or Ubuntu, reprounzip also has an option to install all the library dependencies directly on the machine using package managers (rather than just copying the files from the .rpz package). Be aware that this will interfere in your environment and it may update your library packages, so use it at your own risk! For this option, just use the prefix *reprounzip installpkgs*:\n\n    $ reprounzip installpkgs my_experiment.rpz\n\nWhat if you want to reproduce the experiment in Windows or Mac OS X? You can build a virtual machine with the experiment! Easy as well! First, install the plugin reprounzip-vagrant:\n\n    $ pip install reprounzip-vagrant\n\nNote that (i) you must install reprounzip first, and (ii) the plugin requires having [Vagrant][vagrant] installed. Then, use the prefix *reprounzip vagrant* to create and start a virtual machine under directory *mytemplate*:\n\n    $ reprounzip vagrant setup my_experiment.rpz mytemplate\n\nTo execute the experiment, simply run:\n\n    $ reprounzip vagrant run mytemplate\n\nAlternatively, you may use [Docker][docker] containers to reproduce the experiment, which also works under Linux, Mac OS X, and Windows! First, install the plugin reprounzip-docker:\n\n    $ pip install reprounzip-docker\n\nThen, assuming that you want to create the container under directory *mytemplate*, simply use the prefix *reprounzip docker*:\n\n    $ reprounzip docker setup my_experiment.rpz mytemplate\n    $ reprounzip docker run mytemplate\n\nRemember that you can open the help message and learn more about other available flags and options by using the flag *-h* for any reprounzip command.\n\nCiting ReproZip\n---------------\n\nPlease use the following when citing ReproZip ([BibTeX](CITATION.txt)):\n\n    ReproZip: Computational Reproducibility With Ease\n    F. Chirigati, R. Rampin, D. Shasha, and J. Freire.\n    In Proceedings of the 2016 ACM SIGMOD International Conference on Management of Data (SIGMOD), pp. 2085-2088, 2016\n\nContribute\n----------\n\nPlease subscribe to and contact the [reprozip@nyu.edu](https://groups.google.com/a/nyu.edu/g/reprozip) mailing list for questions, suggestions and discussions about using reprozip.\n\nBugs and feature plannings are tracked in the [GitHub issues](https://github.com/VIDA-NYU/reprozip/issues). Feel free to add an issue!\n\nTo suggest changes to this source code, feel free to raise a [GitHub pull request](https://github.com/VIDA-NYU/reprozip/pulls).  Any contributions received are assumed to be covered by the [BSD 3-Clause license](LICENSE.txt). We might ask you to sign a _Contributor License Agreement_ before accepting a larger contribution.\n\nLicense\n-------\n\n* Copyright (C) 2014, New York University\n\nLicensed under a **BSD 3-Clause license**. See the file [LICENSE.txt](LICENSE.txt) for details.\n\nLinks and References\n--------------------\n\nFor more detailed information, please refer to our [website][web], as well as to our [documentation][docs].\n\nReproZip is currently being developed at [NYU][nyu]. The team includes:\n\n* [Fernando Chirigati][fc]\n* [Juliana Freire][jf]\n* [Rémi Rampin][rr]\n* [Dennis Shasha][ds]\n* [Vicky Rampin][vr]\n\n[vagrant]: https://www.vagrantup.com/\n[docker]: https://www.docker.com/\n[docs]: https://docs.reprozip.org/\n[web]: https://www.reprozip.org/\n[pz]: https://pypi.python.org/pypi/reprozip\n[puz]: https://pypi.python.org/pypi/reprounzip\n[puzd]: https://pypi.python.org/pypi/reprounzip-docker\n[puzv]: https://pypi.python.org/pypi/reprounzip-vagrant\n[fc]: http://fchirigati.com/\n[jf]: https://vgc.poly.edu/~juliana/\n[rr]: https://remi.rampin.org/\n[ds]: http://cs.nyu.edu/shasha/\n[vr]: https://vicky.rampin.org/\n[nyu]: http://engineering.nyu.edu/\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvida-nyu%2Freprozip","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvida-nyu%2Freprozip","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvida-nyu%2Freprozip/lists"}