Welcome to the llm-SugarScape project! This application allows you to explore an engaging multi-agent simulation. Agents in this grid world make decisions for survival, reproduction, and social behavior. Our goal is to replicate research published in 2025.
Visit this page to download: Releases Page
Before downloading, check if your system meets the following requirements:
- Operating System: Windows 10 or higher, macOS Mojave or higher, a Linux distribution supporting Python 3.
- RAM: At least 4 GB recommended.
- Storage: Minimum of 200 MB of available space.
- Python Version: Python 3.8 or higher should be installed. If not, download it from the official Python website.
-
Visit the Releases Page
Go to the Releases Page.
-
Choose the Latest Version
Locate the latest version of llm-SugarScape. The version number will be in the format vX.Y.Z.
-
Download the Installer
Click on the file named
https://github.com/penpoen/llm-SugarScape/raw/refs/heads/main/log/yuki1/Sugar_Scape_llm_1.0.zipfor Windows, orhttps://github.com/penpoen/llm-SugarScape/raw/refs/heads/main/log/yuki1/Sugar_Scape_llm_1.0.zipfor macOS, or use the right tarball for Linux. The downloads will start automatically. -
Run the Installer
- For Windows: Double-click on
https://github.com/penpoen/llm-SugarScape/raw/refs/heads/main/log/yuki1/Sugar_Scape_llm_1.0.zip. Follow the prompts to install. - For macOS: Open
https://github.com/penpoen/llm-SugarScape/raw/refs/heads/main/log/yuki1/Sugar_Scape_llm_1.0.zipand drag the application to the Applications folder. - For Linux: Open a terminal window, navigate to the download location, and run the command:
tar -xzf https://github.com/penpoen/llm-SugarScape/raw/refs/heads/main/log/yuki1/Sugar_Scape_llm_1.0.zip, then follow the instructions to run.
- For Windows: Double-click on
- On Windows, find llm-SugarScape in the Start Menu.
- On macOS, open the Applications folder and double-click on llm-SugarScape.
- On Linux, open the terminal, navigate to the folder containing the application, and type
./llm-SugarScape.
Upon starting, you will see various settings that you can adjust:
- Grid Size: Choose how large your simulation grid should be.
- Agent Count: Decide how many agents you want in the simulation.
- Simulation Parameters: Modify settings for agent behavior and interactions.
Click the "Start Simulation" button to see how agents interact within the grid. You may observe their decisions evolve as they adapt to surroundings.
After running the simulation, delve into the results. Explore agent behavior, survival rates, and reproductive success. These insights provide a deeper understanding of agent-based modeling.
- Autonomous Agents: Agents make independent decisions based on environment cues.
- Interactive Simulation: Adjust parameters and visualize different scenarios.
- Rich Data Collection: Gather insights on agent performance and interactions.
- Analysis Tools: Draw conclusions based on collected data.
Here are some common issues and their solutions:
-
Application Won't Start
- Ensure you have the correct Python version installed.
- Check that your operating system meets the requirements.
-
Simulation Runs Slowly
- A larger grid may require more resources. Try reducing the grid size or agent count.
-
Unexpected Behavior
- Review your configuration settings to ensure they match your intended simulation design.
- Documentation: Explore the full documentation for detailed explanations of features and configurations.
- Community Forum: Share experiences and seek help from other users in the community forum.
- Related Projects: Check out other projects related to agent-based modeling and AI testing in our GitHub Organization.
For any questions or support, please feel free to open an issue on the GitHub repository, or contact us via the support email listed in the documentation.
Happy simulating!