Skip to content

InstallingDevVersion

Jump to bottom
Arthur edited this page Jul 22, 2026 · 5 revisions

Installing the development version

Important note: the current Git version contains 1 main branch:

  • main: that contains the current development version of GAMA (it works with JDK 25 and Eclipse 2026-03).

Changes made to other branches won't be added to the next GAMA release unless they go through the whole pull-request mechanism.

The following tutorial describes the installation for this version.

Install Eclipse 2026-03

Download the "Eclipse IDE for Java and DSL Developers 2026-03". You can also use the Eclipse launcher and choose to install the Eclipse IDE for Java and DSL Developers version. This is the latest version under which GAMA is certified to work.

Note: Regarding Java, Eclipse embeds the Adoptium Temurin 25, which is the recommended version for GAMA, you may be able to use another one, but we won't fix any related issue.

The GAMA code

There are several ways to obtain the GAMA source code via Git. There is no preferred method, but if you need help, one option is described in detail on this page: Download GAMA development code using the Eclipse plugin.

Import projects into workspace

You have now to import projects into the workspace (notice that the folders downloaded during the clone will neither be copied nor moved).

Note: contrarily to previous Eclipse versions, import projects from the Git perspective doesn't work properly for GAMA.

  1. In the Java perspective, choose:
  • File / Import...,

Context Working tree

  • In the install window, select Git / Projects from Git,
  • Click on Next,
  • In the Project from Git window, select Existing local repository.,

Context Local Repository

  • Click on Next,
  • In the new window, select your Git repository,
  • Click on Next,
  • In the Select a wizard to used to import projects, check that
    • Import existing Eclipse projects is selected
    • Working Tree is selected

GIT Import projects

  • Click on Next,

  • In the Import project window,

    • Uncheck Search for nested projects
    • Select all the projects Choose Projects to import

  • Finish

  1. Clean project (Project menu > Clean ...)

If you have errors...

If errors continue to show in the various projects, be sure to correctly set the JDK used in the Eclipse preferences. GAMA (version 2026-06) is targeting JDK 25, and Eclipse could produce errors if it did not find in your environment. So, either you set the compatibility to 25 by default (in Preferences > Java > Compiler > Compiler Compliance Level) or you change the error produced by Eclipse to a warning only (in Preferences > Java > Compiler > Building > "No strictly compatible JRE for execution environment available).

On Windows : if the project still do not compile, try to add the vm argument in eclipse.ini files (inside the directory where your eclipse is installed) before the -startup line Example :

-vm

C:\Program Files\Java\JDK25\bin

-startup 

.....

Run GAMA

  1. Make sure you're in the Java Perspective (top right button)
  2. In the gama.product plugin, open the gama.product file (gama.headless.product is used to produce the headless).
  3. Go to "Overview" tab and click on Synchronize
  4. Click on "Launch an Eclipse Application"

Home

  1. What's new (Changelog)
  2. Migration Guide (2025-06 → 2026-06)

Platform

  1. Installation and Launching
    1. Installation
    2. Launching GAMA
    3. Updating GAMA
    4. Installing Plugins
  2. Workspace, Projects and Models
    1. Navigating in the Workspace
    2. Changing Workspace
    3. Importing Models
  3. Editing Models
    1. GAML Editor (Generalities)
    2. GAML Editor Tools
    3. Validation of Models
  4. Running Experiments
    1. Launching Experiments
    2. Experiments User interface
    3. Controls of experiments
    4. Parameters view
    5. Inspectors and monitors
    6. Displays
    7. Batch Specific UI
    8. Errors View
  5. Running Headless
    1. Getting Started
    2. Headless Legacy
    3. Headless Batch
  6. Preferences
  7. Troubleshooting

Learn GAML step by step

  1. Introduction
    1. Start with GAML
    2. Organization of a Model
    3. Basic programming concepts in GAML
  2. Manipulate basic Species
  3. Global Species
    1. Regular Species
    2. Defining Actions and Behaviors
    3. Interaction between Agents
    4. Attaching Skills
    5. Inheritance
  4. Defining Advanced Species
    1. Grid Species
    2. Graph Species
    3. Mirror Species
    4. Multi-Level Architecture
  5. Defining GUI Experiment
    1. Defining Parameters
    2. Defining Displays Generalities
    3. Defining 3D Displays
    4. Defining Charts
    5. Defining Monitors and Inspectors
    6. Defining Export files
    7. Defining User Interaction
  6. Classes and Objects
    1. Class Definition and Instantiation
    2. Attributes and Actions
    3. Inheritance
    4. Virtual Classes
    5. Advanced Features
  7. Exploring Models
    1. Run Several Simulations
    2. Batch Experiments
    3. Exploration Methods
  8. Optimizing Models
    1. Runtime Concepts
    2. Analyzing code performance
    3. Optimizing Models
  9. Multi-Paradigm Modeling
    1. Control Architecture
    2. Defining Differential Equations

Recipes

  1. Manipulate OSM Data
  2. Cleaning OSM Data
  3. Diffusion
  4. Using Database
  5. Using Dataframes
  6. Using FIPA ACL
  7. Using BDI with BEN
  8. Using Driving Skill
  9. Manipulate dates
  10. Manipulate lights
  11. Using comodel
  12. Save and restore Simulations
  13. Using network
  14. Writing Unit Tests
  15. Ensure model's reproducibility
  16. Going further with extensions
    1. Calling R
    2. Using Graphical Editor
    3. Using Git from GAMA

GAML References

  1. Built-in Species
  2. Built-in Skills
  3. Built-in Architecture
  4. Statements
  5. Data Type
  6. File Type
  7. Stats Extension
  8. Sound Extension
  9. BDI Extension
  10. FIPA Skill
  11. Expressions
    1. Literals
    2. Units and Constants
    3. Pseudo Variables
    4. Variables And Attributes
    5. Operators (Definition)
    6. Operators [A-A]
    7. Operators [B-C]
    8. Operators [D-H]
    9. Operators [I-M]
    10. Operators [N-R]
    11. Operators [S-Z]
  12. Exhaustive list of GAMA Keywords

Developing GAMA

  1. Installing the development version
    1. Install GAMA source code with Eclipse plugin
  2. Developing Extensions
    1. Developing Plugins
    2. Developing Skills
    3. Developing Statements
    4. Developing Operators
    5. Developing Types
    6. Developing Species
    7. Developing Control Architectures
    8. Index of annotations
  3. Introduction to GAMA Java API
    1. Architecture of GAMA
    2. IScope
  4. Using GAMA flags
  5. Creating a release of GAMA
  6. Documentation generation

Tutorials

  1. Predator Prey
  2. Road Traffic
  3. Incremental Model
  4. Luneray's flu
  5. BDI Agents
  6. Forager RL
  7. SIR Analysis
  8. 3D Model

Community

  1. Team
  2. Projects using GAMA
  3. Scientific References
  4. Training Sessions

Versions of GAMA

Resources

  1. Videos
  2. Conferences
  3. Pedagogical materials

Clone this wiki locally