COmmon pool Ressources and Multi-Agent Simulations
Explore the docs »

Report a defect | Request feature

Cormas is a platform for agent-based modelling and simulations implemented in Pharo - a pure object-oriented programming environment.

Cormas was originally developed by the Green research unit (today part of UMR SENS) based on the years of field experience. Cormas was specifically developed to support Companion Modelling (ComMod) - a participatory approach that involves stakeholders in every step of model development and exploration.

Documentation and tutorials about Cormas are available on our website: https://cormas.org

If you want to contribute to CORMAS please have a look to the contributing guide.

Read our Installation Guide for detailed step-by-step instructions on how to install Cormas

• Download the latest stable Pharo image depending of your platform: http://pharo.org/download
• Load Cormas: Open Pharo then select Browse > Playground in the top menu. Paste the script below in Playground then click on Do it (green button in the top-left coirner of Playground) to execute it:

Metacello new
    repository: 'github://cormas/cormas';
    baseline: 'Cormas';
    load.

Use this script if you want the development version of Cormas:

Metacello new
    repository: 'github://cormas/cormas:dev';
    baseline: 'Cormas';
    load.

All packages load into the Cormas-* package names:

You can install CORMAS through Unix command line. It works as follow:

# Create a cormas/ directory and navigate into it
mkdir cormas; cd cormas

# Download Pharo 12 image and virtual machine
curl https://get.pharo.org/120 vm | bash

# Install Cormas
./pharo Pharo.image eval "
    Metacello new
        repository: 'github://cormas/cormas/';
        baseline: 'Cormas';
        load.
    Smalltalk snapshot: true andQuit: true"

Then you can open your Cormas image with user interface:

./pharo-ui Pharo.image

As you use Cormas, you should always save your image (the state of your environment). For that, select Save from the Pharo menu.

Alternatively, if you want to save your image in a custom location, select Save As...:

Then write the name of your choice (e.g.: CormasPharo.image):

Thanks goes to these wonderful people (emoji key):

Oleksandr Zaitsev 💻 ⚠️	Serge Stinckwich 💻 ⚠️	Tomohiro Oda 💻 ⚠️	Etienne DELAY 💻 ⚠️	Hernán Morales Durand 💻 ⚠️	Pierre Bommel 💻	Christophe Le Page 💻
Cédrick Béler 💻	nbecu 💻	npapoylias 💻 ⚠️	Bruno Bonté 💻	Jigyasa Grover 💻	Peter Uhnak 🔧	Géraldine Abrami ⚠️

This project follows the all-contributors specification. Contributions of any kind welcome!

Innocent Bakam, François Bousquet, Alassane Bah, Emmanuel Lieurain, Jean-Christophe Soulié, Paul Guyot, Jean-François Lefevre, Anne Dray.