Skip to content
Agent-based modeling framework in Julia
Julia Python TeX
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
benchmark/forest_fire Agents.jl vs Mesa benchmark, update paper Jul 22, 2019
docs add logo, mention juliadynamics (#35) Oct 12, 2019
examples Modified Boltzmann agent_step! to move agents. Aug 20, 2019
src Update the paper Sep 30, 2019
test Make some small improvements Sep 5, 2019
.gitignore Minor Jul 31, 2019
.travis.yml Test travis Jul 3, 2019 Added a paragraph about building the docs locally. Jul 23, 2019 Add license May 1, 2019
Manifest.toml Update dependencies Oct 8, 2019
Project.toml Move to v1.1.8 for the paper Oct 8, 2019 add logo, mention juliadynamics (#35) Oct 12, 2019
REQUIRE Change documenter files Dec 13, 2018

Agents.jl: agent-based modeling framework in Julia


status Build Status

Agents.jl is a Julia framework for agent-based modeling (ABM). It provides a structure and components for quickly implementing agent-based models, run them in batch, collect data, and visualize them. To that end, it provides the following functionalities:

  • Default grids to run the simulations, including simple or toroidal 1D grids, simple or toroidal regular rectangular and triangular 2D grids, and simple or toroidal regular cubic 3D grids with von Neumann or Moore neighborhoods.
  • Running the simulations in parallel on multiple cores.
  • Automatic data collection in a DataFrame at desired intervals.
  • Exploring the simulation results interactively in Data Voyager 2.
  • Batch running and batch data collection.
  • Visualizing agent distributions on grids.

Julia is a language that is especially suitable for ABMs, because a) it runs fast, b) it is easy to express your ideas in and quick to write, and c) it has rich and easy-to-use packages for data analysis.

Agents.jl is lightweight and modular. It has a short learning curve, and allows one to extend its capabilities and express complicated modeling scenarios. Agents.jl is inspired by Mesa framework for Python.


Install using the following command inside Julia:

]add Agents

It is compatible with Julia 0.7+.

For a tutorial, read the docs:


Any contribution to Agents.jl is welcome in the following ways:

  • Modifying the code or documentation with a pull request.
  • Reporting bugs and suggestions in the issues section of the project's Github.

Previewing Documentation Edits

Modifications to the documentation can be previewed by building the documentation locally, which is made possible by a script located in docs/make.jl. The Documenter package is required and can be installed by running import Pkg; Pkg.add("Documenter") in a REPL session. Then the documentation can be built and previewed in build/ first by running julia docs/make.jl from a terminal.


If you use this package in a publication, please cite the paper below:

R. Vahdati, Ali (2019). Agents.jl: agent-based modeling framework in Julia. Journal of Open Source Software, 4(42), 1611,

You can’t perform that action at this time.