Skip to content
Deep universal probabilistic programming with Python and PyTorch
Branch: dev
Clone or download
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Create issue_template.md (#1096) Apr 25, 2018
docker
docs Clean up requirements (#1768) Feb 20, 2019
examples Using cache from Transform and event_dim=1 (#1638) Feb 22, 2019
profiler Sort imports via isort (#1074) Apr 24, 2018
pyro
scripts Increase perf regression threshold for CI and use process time (#1048) Apr 19, 2018
tests `module` will ignore params with requires_grad=False (#1779) Mar 1, 2019
tutorial update docs urls (#1757) Feb 14, 2019
.codecov.yml disable codecov comments (#1366) Sep 6, 2018
.coveragerc add coverage config file (#1297) Aug 8, 2018
.gitattributes
.gitignore Add mixed-effect HMM example with seal data (#1732) Feb 6, 2019
.travis.yml
CODE_OF_CONDUCT.md
CONTRIBUTING.md add cuda mode to contributing (#1767) Feb 19, 2019
LICENSE.md
Makefile correct egg info file in makefile (#1766) Feb 19, 2019
README.md Fix setup.py and long_description rendering (#1758) Feb 13, 2019
setup.cfg Ignore ipynb_checkpoints for flake8 and isort (#1765) Feb 19, 2019
setup.py

README.md


Build Status codecov.io Latest Version Documentation Status

Getting Started | Documentation | Community | Contributing

Pyro is a flexible, scalable deep probabilistic programming library built on PyTorch. Notably, it was designed with these principles in mind:

  • Universal: Pyro is a universal PPL - it can represent any computable probability distribution.
  • Scalable: Pyro scales to large data sets with little overhead compared to hand-written code.
  • Minimal: Pyro is agile and maintainable. It is implemented with a small core of powerful, composable abstractions.
  • Flexible: Pyro aims for automation when you want it, control when you need it. This is accomplished through high-level abstractions to express generative and inference models, while allowing experts easy-access to customize inference.

Pyro is in a beta release. It is developed and maintained by Uber AI Labs and community contributors. For more information, check out our blog post.

Installing

Installing a stable Pyro release

Install using pip:

pip install pyro-ppl

Install from source:

git clone git@github.com:pyro-ppl/pyro.git
cd pyro
git checkout master  # master is pinned to the latest release
pip install .

Install with extra packages:

To install the dependencies required to run the probabilistic models included in the examples/tutorials directories, please use the following command:

pip install pyro-ppl[extras] 

Make sure that the models come from the same release version of the Pyro source code as you have installed.

Installing Pyro dev branch

For recent features you can install Pyro from source.

Install using pip:

pip install git+https://github.com/pyro-ppl/pyro.git

or, with the extras dependency to run the probabilistic models included in the examples/tutorials directories:

pip install git+https://github.com/pyro-ppl/pyro.git#egg=project[extras]

Install from source:

git clone https://github.com/pyro-ppl/pyro
cd pyro
pip install .  # pip install .[extras] for running models in examples/tutorials

Running Pyro from a Docker Container

Refer to the instructions here.

Citation

If you use Pyro, please consider citing:

@article{bingham2018pyro,
  author = {Bingham, Eli and Chen, Jonathan P. and Jankowiak, Martin and Obermeyer, Fritz and
            Pradhan, Neeraj and Karaletsos, Theofanis and Singh, Rohit and Szerlip, Paul and
            Horsfall, Paul and Goodman, Noah D.},
  title = {{Pyro: Deep Universal Probabilistic Programming}},
  journal = {arXiv preprint arXiv:1810.09538},
  year = {2018}
}
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.