Skip to content

njoppi2/multi-agent-miners

Repository files navigation

Multi-Agent Miners

CI License Last Commit

Academic multi-agent mining project built with Jason for the INE5430 AI course, co-developed with @IgorMayWensing.

Snapshot

Multi-agent miners simulation board with agents and resources

Problem

Coordinate multiple agents to discover, share, prioritize, and mine distributed resources using collaborative beliefs and plans.

Tech Stack

  • Jason (AgentSpeak)
  • Java / Ant tooling
  • Bash helper scripts

Repository Layout

Project-specific files are mainly:

  • projetos/semincoMineradores/semincoMineradores.mas2j
  • projetos/semincoMineradores/src/asl/col.asl
  • projetos/semincoMineradores/src/asl/builder.asl

The repository also includes Jason runtime and examples.

Implemented Behaviors

  • Global broadcast of discovered resources
  • Global broadcast of resource depletion updates
  • Local cache of non-target resources while searching
  • Return-to-search-position after collaborative mining
  • Priority ordering based on distance to builder

Quickstart

From repository root:

./scripts/jason projetos/semincoMineradores/semincoMineradores.mas2j

Alternative:

cd projetos/semincoMineradores
ant -f bin/build.xml run

Validation and CI

Local checks:

bash -n scripts/jason
bash -n scripts/jason-setup
bash -n scripts/jason-ide
bash -n scripts/jason-new-project
bash -n scripts/mas2j
python -m unittest discover -s tests -p "test_*.py"

CI (.github/workflows/ci.yml) validates key project files, helper script shell syntax, and scenario assertions for coordination plans.

Results

  • Shared coordination belief (group_found(...)) is integrated into team behavior.
  • Agents coordinate candidate resources with consistent shared priority.
  • Repository has baseline CI sanity coverage for critical project files/scripts.

Limitations

  • Repo includes framework/vendor assets, increasing footprint.
  • No automated simulation assertions for behavior outcomes yet.
  • Evaluation is still mostly qualitative/manual.

Roadmap

  • Add reproducible scenarios with expected cooperative outcomes.
  • Add automated scenario assertions for project-specific ASL plans.
  • Split or slim vendor/framework assets from project logic.

Contributing

See CONTRIBUTING.md.

About

Jason multi-agent mining coordination project with cooperative resource discovery strategies.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors