Skip to main content
Donate to the Python Software Foundation or Purchase a PyCharm License to Benefit the PSF! Donate Now

MASSpy is a package for kinetic modeling and simulation of biological networks

Project description

masspy - Mass Action Stoichiometric Simulation in Python

What is masspy?

The Mass Action Stoichiometric Simulation for Python (masspy) is a modeling software package for the construction and analysis of kinetic models of biochemical reaction systems.

One of the main goals of masspy is to integrate seamlessly with cobrapy, a widely used constraint-based reconstruction and analysis python package in order to provide a wide range of modeling techniques that can be utilized seperately or together. For further information about cobrapy, please visit their github page.


A manuscript is in preparation for publication and will be the proper reference for citing the masspy in the future.


The recommended method to install masspy is to use pip to install masspy from PyPI (we recommend doing this inside a virtual environment):

pip install masspy

If you downloaded the source code, run:

pip install -e .

in the masspy directory. For additional information, please refer to the the detailed installation instructions.


Contributions are always welcome! Please read the contributions guideline to get started.


The masspy source is released under both the GPL and LGPL licenses. You may choose which license you choose to use the software under.

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License or the Lesser GNU General Public License as published by the Free Software Foundation, either version 2 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.

Installation of masspy

All releases require Python 3.4+ to be installed before proceeding. Mac OS X (10.7+) and Ubuntu ship with Python. Windows users without python can download and install python from the python website. Please note that though Anaconda and other python distributions may work with masspy, they are not explicitly supported (yet!).

Stable version installation

masspy can be installed with any recent installation of pip. Instructions for several operating systems are below:

Mac OS X or Linux

  1. install pip.
  2. In a terminal, run sudo pip install mass

We highly recommend updating pip beforehand (pip install pip --upgrade).

Microsoft Windows

The preferred installation method on Windows is also to use pip. The latest Windows installers for Python 3.4 and up include pip, so if you use those you will already have pip.

1. In a terminal, run C:\Python36\Scripts\pip.exe install masspy (you may need to adjust the path accordingly).

To install without pip, you will need to download and use the appropriate installer for your version of python from the python package index.

Installation for development

Get the detailed contribution instructions for contributing to masspy.

Installation of optional dependencies

Optional dependencies

On windows, these can downloaded from this site. On Mac/Linux, they can be installed using pip, or from the OS package manager (e.g brew, apt, yum).

  1. libsbml >= 5.10 to read/write SBML level 2 files

2. lxml to speed up read/write of SBML level 3 files. You can install all packages directly by:

pip install "masspy[all]"

Testing your installation

Currently masspy is still under development and testing. We apologize for the inconvenience and provide further details on this page in a future update.

For now, if you have any questions or concerns, please email with “masspy concerns” in the subject line and we will get back to you as soon as we can.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
masspy-0.1.0a33-py3-none-any.whl (166.3 kB) Copy SHA256 hash SHA256 Wheel py3
masspy-0.1.0a33.tar.gz (150.5 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page