Skip to content

matanitah/emergant

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

42 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🐜 Emergant: An Ant Colony Simulator 🐜

A world of tiny creatures, driven by simple rules, yet creating complex societies.

🎯 About

Emergant is an ant colony simulator built with PyGame, where reinforcement learning drives the emergence of lifelike ant behaviors. Watch as virtual ants forage for food, defend their nests, and adapt their strategies over time—all without explicit scripting of their behaviors!

How It Works

  • 🌱 Reinforcement Learning – Ants from the same colony are all collected by one hivemind, and learn to bring food back to their colony using a system of rewards and penalties.
  • 🧠 Neuroevolutionary Algorithm - The neural network structure of each hivemind evolves from generation to generation through natural selection.
  • 🎮 PyGame Visualization – The simulation runs in real-time with an interactive graphical interface. There is also a neural network visualization utility to get deeper insights into the weights of the networks and to increase explainability.

📸 Screenshots & Demo

(Insert GIFs or screenshots of the simulation in action!)

🚀 Getting Started

▶️ Run the Simulation

  1. Clone the repository:
    git clone https://github.com/matanitah/emergant.git
    cd emergant
  2. Install dependencies:
    pip install -r requirements.txt
  3. Start the simulation:
    python src/main.py

Contact

Reach out to me on Linkedin at https://www.linkedin.com/in/matan-itah/ if you are interested in becoming a collaborator.

📜 License

MIT License – Free to use and modify!

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published