From BioNetWiki

(Difference between revisions)
Jump to: navigation, search
Revision as of 20:06, 30 November 2016
Faeder (Talk | contribs)
(RuleBender Stable)
← Previous diff
Revision as of 20:06, 13 February 2017
Rhclark (Talk | contribs)
(RuleBender Stable)
Next diff →
Line 8: Line 8:
*'''Download''' - Obtain the current, stable RuleBender distribution by clicking on the appropriate link for your operating system below: *'''Download''' - Obtain the current, stable RuleBender distribution by clicking on the appropriate link for your operating system below:
-** [ Mac] See Java prerequisites at** [ Mac] See Java prerequisites at or try [ Mac-2.2-beta]
** [ Linux] ** [ Linux]
** [ Windows] ** [ Windows]

Revision as of 20:06, 13 February 2017

This page describes three different ways to get BioNetGen running in a few steps from your computer. To learn how to write, simulate, and analyze rule-based models, please see Tutorials and Documentation.

When publishing papers using that use any our our rule-based modeling tools, please follow our citation guidelines. If you encounter problems with installation or operation of the tools below please send an email to

RuleBender Stable

Full-featured integrated development environment for BioNetGen and NFsim based on Eclipse RCP. We strongly recommend you try this first.

  • Download - Obtain the current, stable RuleBender distribution by clicking on the appropriate link for your operating system below:
  • Install - Unzip the directory wherever you would like it installed, open the folder and click on the application with the RuleBender (RB) icon.
    • Some users may need to install or upgrade their Java. Windows users: You currently need to run RuleBender using 32-bit Java - 64 bit DOES NOT work. We are working on a 64 bit version for the next release.
    • Windows users may need to install Perl. The current Windows release requires 32 bit Perl to function correctly. We recommend Strawberry Perl (32 bit version).
    • More information about installing Perl and Java can be found in the RuleBender file:
    • Legacy versions of RuleBender for all operating systems are available here.
    • For help on installing and configuring RuleBender distributions please send email to
    • We also highly recommend that you install the yEd Graph Editor, which can be used for interactive visualizations generated by the visualize command.
  • Learn - We recommend that you first watch our tutorial video. To view and simulate models in RuleBender you will need to be able to
    • Select a Sample Model by doing: File->New BioNetGen Project-> OK -> Open the dropdown menu and select a model file.
    • Create a new Project by clicking OK in the file selection dialogue box.
      • If RuleBender indicates that it has not located BioNetGen on your computer, please do the following: Window->Preferences...->Simulator and browsing to the directory containing BioNetGen (e.g., /Users/shmo/RuleBender-2.0.388-osx64/BioNetGen-2.2.6).
    • To run the simulation contained in your sample file, click on Simulate, then do a single click on the file name (in the left margin) to transfer the filename to the Simulate" dialog. Then click Run.

Once you have RuleBender up and running, we recommend that you move on to our Tutorials.

Archived Versions of RuleBender

BioNetGen Command-line Interface

For users who only want the command-line interface.

  1. Download the latest source code + binary distribution from BioNetGen Distributions.
  2. Go to the Installation Guide and follow the instructions for Mac, Linux, or Windows.

BioNetGen at Virtual Cell

An excellent way to learn rule-based modeling using a lightweight client application, but currently uses an older BioNetGen distribution that lacks many current features.

  1. Go to BioNetGen@VCell web site and click on Run BioNetGen link on the right.
  2. Register if necessary (which involves completing a 1-page form, after which you will be granted immediate access) and click on the BioNetGen menu tab in the main Virtual Cell window.
  3. Export of BNG models to Virtual Cell allows spatial simulations using PDE's.

For help with BioNetGen@VCell please send email to

Related Tools

In addition the following tools provide simulation capabilities for rule-based models specified in the BioNetGen Language:

Personal tools