Skip to Main Content U.S. Department of Energy

Download and Install MIF

The zip distributions of MIF listed here are compatible with all operating systems. They have been tested on Windows XP, Linux, and Mac OS X.

Most Recent Version

Older versions




If you will be using the MIF Component Builder, you will need to download the latest version of Eclipse. Choose the package called “Eclipse Modeling Tools” from: Eclipse Download Page

Install MIF

  • Unzip the distribution into a directory path that does not contain any spaces (this directory is called MIF_HOME throughout the documentation).
  • UNIX only: make the scripts in the bin directory executable with the command
chmod 755 bin/*.sh

Getting Started

Verify Installation

To quickly verify the installation, you can run the Hello World Sample in a console window by first changing to the MIF_HOME directory. Then run the following command and enter a name when prompted:


bin/ -c gov.pnnl.mif.samples.hello.stdio.HelloStdioDriver


bin\mif.bat -c gov.pnnl.mif.samples.hello.stdio.HelloStdioDriver

Program output

After you run the above command and enter your name when prompted, you should see the following messages in the console. If you see a similar message, you have a valid installation.

enter name:Dave
HelloNameProcessor: Hey, Dave
HelloHalProcessor: Hey, Dave, what are you doing?
Hey, Dave, what are you doing?

What's included

The MIF ZIP distribution contains everything you need to run MIF. This includes:

  • The MIF API
  • API documentation in the form of javadocs (in MIF_HOME/apidocs)
  • MIF Source code (MIF_HOME/sources/mif-core)
  • Sample code (MIF_HOME/sources/mif-samples)
  • Dependency libraries (MIF_HOME/lib)
  • Launcher scripts (MIF_HOME/bin)

Developing Against the MIF API

Developers can build MIF components and pipelines using the MIF Java API or by using a graphical component builder which can automatically generate much of the code needed to create a MIF pipeline. Instructions for setting up a Java development environment are listed below. Follow these instructions for obtaining and using the MIF Component Builder

IDE Setup

For ease of development in an IDE, we provide a single jar (MIF_HOME/mif-vers-all.jar) containing the MIF API and all dependency jars. So, developers can use their IDE of choice by taking these steps:

  • Create a new Java project in the IDE
  • Include the MIF-all jar (MIF_HOME/mif-vers-all.jar) in the project's build path
  • To work with the samples, import (MIF_HOME/sources/mif-samples) into the project

If you are using Eclipse for development, you can follow these instructions to Create a MIF Project in Eclipse to set up your MIF project.

Using MIF in Server Mode

In order to run MIF as a server, follow the MIF Server Instructions



Notice: This computer software was prepared by Battelle Memorial Institute, hereinafter the Contractor, under Contract No. DE-AC05-76RL01830 with the Department of Energy (DOE). All rights in the computer software are reserved by DOE on behalf of the United States Government and the Contractor as provided in the Contract. NEITHER THE GOVERNMENT NOR THE CONTRACTOR MAKES ANY WARRANTY, EXPRESS OR IMPLIED, OR ASSUMES ANY LIABILITY FOR THE USE OF THIS SOFTWARE. This notice including this sentence must appear on any copies of this computer software.


MeDICi is distributed under a BSD-style license, referred to as the Standard PNNL OSS Liscense

For More Information

download_mif.txt · Last modified: 2010/09/25 10:07 by adamw