https://github.com/amzn/MXFusion

Modular Probabilistic Programming on MXNet
https://github.com/amzn/MXFusion

bayesian-inference machine-learning mxnet probabilistic-programming python variational-inference

Last synced: 3 months ago
JSON representation

Modular Probabilistic Programming on MXNet

• Host: GitHub
• URL: https://github.com/amzn/MXFusion
• Owner: amzn
• License: apache-2.0
• Archived: true
• Created: 2018-07-31T17:47:44.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2023-04-10T09:52:55.000Z (over 1 year ago)
• Last Synced: 2024-07-26T07:41:54.146Z (3 months ago)
• Topics: bayesian-inference, machine-learning, mxnet, probabilistic-programming, python, variational-inference
• Language: Python
• Homepage:
• Size: 6.98 MB
• Stars: 102
• Watchers: 19
• Forks: 31
• Open Issues: 52
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

• Awesome-MXNet - **MXFusion**

README

        
# MXFusion

[![Build Status](https://travis-ci.org/amzn/MXFusion.svg?branch=master)](https://travis-ci.org/amzn/MXFusion) |

[![codecov](https://codecov.io/gh/amzn/MXFusion/branch/master/graph/badge.svg)](https://codecov.io/gh/amzn/MXFusion) |

[![pypi](https://img.shields.io/pypi/v/mxfusion.svg?style=flat)](https://pypi.org/project/mxfusion/) |

[![Documentation Status](https://readthedocs.org/projects/mxfusion/badge/?version=master)](https://mxfusion.readthedocs.io/en/master/?badge=master) |

[![GitHub license](https://img.shields.io/github/license/amzn/mxfusion.svg)](https://github.com/amzn/mxfusion/blob/master/LICENSE)

![MXFusion](docs/images/logo/blender-small.png)

[Tutorials](https://mxfusion.readthedocs.io/en/master/tutorials.html) |

[Documentation](https://mxfusion.readthedocs.io/en/master/index.html) |

[Contribution Guide](CONTRIBUTING.md)

MXFusion is a modular deep probabilistic programming library.

With MXFusion Modules you can use state-of-the-art inference techniques for specialized probabilistic models without needing to implement those techniques yourself. MXFusion helps you rapidly build and test new methods at scale, by focusing on the modularity of probabilistic models and their integration with modern deep learning techniques.

MXFusion uses [MXNet](https://github.com/apache/incubator-mxnet) as its computational platform to bring the power of distributed, heterogenous computation to probabilistic modeling.

## Installation

### Dependencies / Prerequisites

MXFusion's primary dependencies are MXNet >= 1.3 and Networkx >= 2.1.

See [requirements](requirements/requirements.txt).

### Supported Architectures / Versions

MXFusion is tested on Python 3.4+ on MacOS and Linux.

### Installation of MXNet

There are multiple PyPi packages of MXNet. A straight-forward installation with only CPU support can be done by:

```

pip install mxnet

```

For an installation with GPU or MKL, detailed instructions can be found on [MXNet site](https://mxnet.apache.org/install/).

### pip

If you just want to use MXFusion and not modify the source, you can install through pip:

```

pip install mxfusion

```

### From source

To install MXFusion from source, after cloning the repository run the following from the top-level directory:

```

pip install .

```

## Where to go from here?

[Tutorials](https://mxfusion.readthedocs.io/en/master/tutorials.html)

[Documentation](https://mxfusion.readthedocs.io/en/master/index.html)

[Contributions](CONTRIBUTING.md)

## Community

We welcome your contributions and questions and are working to build a responsive community around MXFusion. Feel free to file an Github issue if you find a bug or want to request a new feature.

## Contributing

Have a look at our [contributing guide](CONTRIBUTING.md), thanks for the interest!

Points of contact for MXFusion are:

* Eric Meissner (@meissnereric)

* Zhenwen Dai (@zhenwendai)

## License

MXFusion is licensed under Apache 2.0. See [LICENSE](LICENSE).