pyro-ppl 0.2.0

A Python library for probabilistic modeling and inference

.. raw:: html

<div align="center">

.. raw:: html

</div>

--------------


`Getting Started <http://pyro.ai/examples>`__ \|
`Documentation <http://docs.pyro.ai/>`__ \|
`Community <http://forum.pyro.ai/>`__ \|
`Contributing <https://github.com/uber/pyro/blob/master/CONTRIBUTING.md>`__

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 an alpha release. It is developed and used by `Uber AI
Labs <http://uber.ai>`__. For more information, check out our `blog
post <http://eng.uber.com/pyro>`__.

Installing
----------

Installing a stable Pyro release
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

First install `PyTorch <http://pytorch.org/>`__.

Install via pip:

**Python 2.7.*:**

.. code:: sh

pip install pyro-ppl

**Python 3.5:**

.. code:: sh

pip3 install pyro-ppl

**Install from source:**

.. code:: sh

git clone [e-mail]:uber/pyro.git
cd pyro
git checkout master # master is pinned to the latest release
pip install .

**Install with extra packages:**

.. code:: sh

pip install pyro-ppl[extras] # for running examples/tutorials

Installing Pyro dev branch
~~~~~~~~~~~~~~~~~~~~~~~~~~

For recent features you can install Pyro from source.

To install a compatible CPU version of Pytorch on OSX / Linux, you could
use the PyTorch install helper script.

::

bash scripts/install_pytorch.sh

Alternatively, build PyTorch following instructions in the PyTorch
`README <https://github.com/pytorch/pytorch/blob/master/README.md>`__.

.. code:: sh

git clone --recursive https://github.com/pytorch/pytorch
cd pytorch
git checkout 200fb22 # <---- a well-tested commit

On Linux:

.. code:: sh

python setup.py install

On OSX:

.. code:: sh

MACOSX_DEPLOYMENT_TARGET=10.9 CC=clang CXX=clang++ python setup.py install

Finally install Pyro

.. code:: sh

git clone https://github.com/uber/pyro
cd pyro
pip install .

Running Pyro from a Docker Container
------------------------------------

Refer to the instructions `here <docker/README.md>`__.