ISAcreator is a Java desktop application which allows for the creation and editing of ISA-Tab files. Originally developed by Eamonn Maguire, with further contributions by Alejandra Gonzalez-Beltran and Philippe Rocca-Serra (Uni. of Oxford).
Java Other
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

ISAcreator is a Java desktop application which allows for creation and editing of ISATab files.

ISAcreator is the ISAtools Java-based desktop editor for producing ISA-Tab files.

For programmatic management of ISA metadata for experimental descriptions (ISA-Tab and ISA-json representations), please check the ISA-API, which is a Python-based API to parse, create, convert ISA metadata among other functionality.



Build Status Coverage Status

Running ISAcreator

To run ISAcreator locally:

  1. Clone the code to your machine. You may clone from the primary repository at ISA-tools/ISAcreator, or from your own fork.
  2. Compile the code (./ This script runs the maven command (mvn assembly:assembly -Dmaven.test.skip=true -Pbuild) after downloading the required configuration (without which the tests will fail) and example ISAtab files. The build profile automatically sets some system variables, such as version, from information held within the pom.
  3. Run the code (java -cp target/ISAcreator-<version number>.jar org.isatools.isacreator.launch.ISAcreatorApplication)


You should read this article about Github Flow: Although we don't strictly use Github flow, it's a really useful tutorial on how to use Git for collaborative development.

Ensure you have maven 2.2.1 installed and enabled as well as git. If you have trouble with dependencies, and you are running behind a proxy, please ensure you set the proxy in both MAVEN_OPTS and settings.xml. See here for more information.

  1. Fork it.
  2. Clone your forked repository to your machine
  3. Create a branch off of the development branch (git checkout -b myisacreator)
  4. Make and test your changes
  5. Run the tests (mvn clean test)
  6. Commit your changes (git commit -am "Added something useful")
  7. Push to the branch (git push origin myisacreator)
  8. Create a Pull Request from your branch.
  9. Promote it. Get others to drop in and +1 it.

Refreshing your code against the master repository.

A simple git pull

Contributor License Agreement

Before we can accept any contributions to ISAcreator, you need to sign a CLA:

Please email us at to receive the CLA. Then you should sign this and send it back asap so we can add you to our development pool.

The purpose of this agreement is to clearly define the terms under which intellectual property has been contributed to ISAcreator and thereby allow us to defend the project should there be a legal dispute regarding the software at some future time.

For a list of contributors, please see


CPAL License, available at