Skip to content

Latest commit

 

History

History
35 lines (29 loc) · 1.65 KB

README.md

File metadata and controls

35 lines (29 loc) · 1.65 KB

🐜 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!