Imagine if you could turn an LLM into a simulator

Interface for turning AgentTorch into an MCP server - build, evaluate and analyze simulations.

Features

• Dark Mode UI: Easy on the eyes with a modern dark interface
• Claude-like Chat Interface: Interact naturally with the simulation system
• Real-time Visualization: See simulation progress and population dynamics
• LLM-powered Analysis: Get intelligent insights about simulation behavior
• Sample Prompts: Quick-start with pre-written questions and scenarios

Setup

1. Make sure you have the required Python packages: pip install -r requirements.txt

2. Ensure you have set the ANTHROPICAPIKEY environment variable: bash export ANTHROPIC_API_KEY=your_api_key_here

3. Verify that the data directory exists at the correct location: services/data/18x25/

Running the Server

Start the server with: python server.py

Then access the interface at http://localhost:8000

How to Use

1. Ask a Question: Type a question in the input box or select a sample prompt
2. Run Simulation: Click "Run Simulation & Analyze" to start the process
3. Watch Simulation: View real-time logs and progress updates
4. See Results: When complete, the population chart will be displayed
5. Get Analysis: The LLM will automatically analyze the results based on your question

Sample Prompts

The interface includes several sample prompts you can try: - What happens to prey population when predators increase? - How does the availability of food affect the predator-prey dynamics? - What emergent behaviors appear in this ecosystem? - Analyze the oscillations in population levels over time - What would happen if the nutritional value of grass was doubled?

Project Structure

├── server.py # Main FastAPI server ├── requirements.txt # Dependencies ├── static/ # Static CSS files │ └── styles.css # Dark mode styling ├── templates/ # HTML templates │ └── index.html # Main UI with chat interface ├── services/ # Service layer │ ├── simulation.py # Simulation service using AgentTorch │ ├── llm.py # LLM service using Claude API │ └── data/ # Simulation data files │ └── 18x25/ # Grid size specific data files

Technical Notes

• The simulation uses AgentTorch framework and the provided config.yaml
• WebSockets enable real-time updates during simulation
• The UI is designed to work well on both desktop and mobile devices
• LLM analysis is powered by the Claude API