Documentation Tutorials Download Contribute


Demonstration of some of the features of the GAMA Platform

GAMA is a simulation platform, which aims at providing field experts, modellers, and computer scientists with a complete modelling and simulation development environment for building spatially explicit multi-agent simulations. It has been first developed by the Vietnamese-French research team MSI (located at IFI, Hanoi, and part of the IRD/UPMC International Research Unit UMMISCO) from 2007 to 2010, and is now developed by a consortium of academic and industrial partners led by UMMISCO, among which the University of Rouen, France, the University of Toulouse 1, France, the University of Orsay, France, the University of Can Tho, Vietnam, the National University of Hanoi, EDF R&D, France, and CEA LISC, France.

Gama 1.6 Trailer. Agent-based simulation platform

Some of the features of GAMA are illustrated in the videos above (more can be found in our Youtube channel).

Beyond these features, GAMA also offers:

  • A complete modeling language, GAML, for modeling agents and environments
  • A large and extensible library of primitives (agent’s movement, communication, mathematical functions, graphical features, …)
  • A cross-platform reproducibility of experiments and simulations
  • A powerful declarative drawing and plotting subsystem
  • A flexible user interface based on the Eclipse platform
  • A complete set of batch tools, allowing for a systematic or “intelligent” exploration of models parameters spaces


The documentation of GAMA is available online on the wiki of the project. It is organized around a few central activities (installing GAMA, writing models, running experiments, developing new extensions to the platform) and provides complete references on both the GAML language, the platform itself, and the scientific aspects of our work (with a complete bibliography). Several tutorials are also provided in the documentation in order to minimize the learning curve, allowing users to build, step by step, the models corresponding to these tutorials, which are of course shipped with the platform.

The documentation can be accessed from the side bar of this page. A good starting point for new users is the installation page.

A standalone version of the documentation, in PDF format, can be directly downloaded here

Source Code

GAMA can be downloaded as a regular application or built from source, which is necessary if you want to contribute to the platform. The source code is available from this GITHub repository:

Which you can also browse from the web here. It is, in any case, recommended to follow the instructions on this page in order to build GAMA from source.

This is a free software (distributed under the GNU GPL v3 license), so you can have access to the code, edit it and redistribute it under the same terms. Independently of the licensing issues, if you plan on reusing part of our code, we would be glad to know it !


GAMA is being designed, developed and maintained by an active group of researchers coming from different institutions in France and Vietnam. Please find below a short introduction to each of them and a summary of their contributions to the platform:

  • Alexis Drogoul, Senior Researcher at the IRD, member of the UMMISCO International Research Unit. Mostly working on agent-based modeling and simulation. Has contributed and still contributes to the original design of the platform, including the GAML language (from the meta-model to the editor) and simulation facilities like Java2D displays.
  • Patrick Taillandier, Associate Professor at the University of Rouen, member of the IDEES CNRS Mixed Research Unit. Contributes since 2008 to the spatial and graph features (GIS integration, spatial operators) and to parameter space search algorithms. Currently working on new features related to graphical modeling and traffic simulation.
  • Benoit Gaudou, Associate Professor at the University Toulouse 1 Capitole, member of the IRIT CNRS Mixed Research Unit. Contributes since 2010 to documentation and unit test generation and coupling mathematical (ODE and PDE) and agent paradigms.
  • Arnaud Grignard, software engineer and PhD fellow (PDI-MSC) at UPMC. Contributes since 2011 to the development of new features related to visualization (3D Display), online analysis and interaction.
  • Huynh Quang Nghi, software engineering lecturer at CTU and PhD fellow (PDI-MSC) at UPMC. Contributes since 2012 to the development of new features related to GAML parser, coupling formalisms in EBM-ABM and ABM-ABM.
  • Truong Minh Thai, software engineering lecturer at CTU and PhD fellow (PRJ322-MOET) at IRIT-UT1. Contributes since 2012 to the development of new features related to data management and analysis.
  • Nicolas Marilleau, Researcher at the IRD, member of the UMMISCO International Research Unit and associate researcher at DISC team of FEMTO-ST institute. Contributes since 2010 to the development of headless mode and the high performance computing module.
  • Philippe Caillou, Associate professor at the University Paris Sud 11, member of the LRI and INRIA project-team TAO. Contributes since 2012 and actually working on charts, simulation analysis and BDI agents.
  • Vo Duc An, Post-doctoral Researcher, working on synthetic population generation in agent-based modelling, at the UMMISCO International Research Unit of the IRD. Has contributed to bringing the platform to the Eclipse RCP environment and to the development of several features (e.g., the FIPA-compliant agent communication capability, the multi-level architecture).
  • Truong Xuan Viet, software engineering lecturer at CTU and PhD fellow (PDI-MSC) at UPMC. Contributes since 2011 to the development of new features related to R caller, online GIS (OPENGIS: Web Map Service - WMS, Web Feature Services - WMS, Google map, etc).
    • Samuel Thiriot

Citing GAMA

If you use GAMA in your research and want to cite it (in a paper, presentation, whatever), please use this reference:

A. Grignard, P. Taillandier, B. Gaudou, D-A. Vo, N-Q. Huynh, A. Drogoul (2013), GAMA 1.6: Advancing the Art of Complex Agent-Based Modeling and Simulation. In ‘PRIMA 2013: Principles and Practice of Multi-Agent Systems’, Lecture Notes in Computer Science, Vol. 8291, Springer, pp. 117-131.

or you can choose to cite the website instead:

GAMA Platform website,

A complete list of references (papers and PhD theses on or using GAMA) is available on the references page.

Contact Us

The best way to get in touch with the developers of GAMA is to sign in for the mailing list. If you wish to contribute to the platform, you might want, instead or in addition, to sign in for the mailing list. On both lists, we generally answer quite quickly to requests.

Finally, if you think you have found a bug in GAMA, or if you absolutely need a feature that does not exist yet, it is much more efficient and time-saving for everyone (including current and future users) to create a new issue report. Please refer to these instructions to do so.