A sophisticated genetic algorithm simulation featuring a complete evolutionary ecosystem with entities, plants, tools, environmental modification, emergent behaviors, and real-time visualization.
- Dynamic Genetic System: 15+ heritable traits with DNA/RNA representation and cellular evolution
- Multi-Species Ecosystem: Herbivores, predators, omnivores with complex interactions
- Plant Life System: 6 plant types with underground networks and wind-based pollen dispersal
- Environmental Systems: Day/night cycles, seasons, weather patterns, and geological events
- Species Formation: Automatic speciation through genetic distance and reproductive barriers
- 🔧 Tool Creation: 10 tool types with crafting, durability, and modification systems
- 🏗️ Environmental Modification: 12 modification types including tunnels, traps, shelters, and farms
- 🧠 Emergent Behaviors: 8 discoverable behaviors with social learning and natural emergence
- 🌐 Real-time Web Interface: WebSocket-based web visualization with all 14 view modes
- 💾 State Persistence: Complete save/load functionality with JSON serialization
- 🔬 Underground Networks: Plant communication and resource sharing through mycorrhizal networks
- CLI Interface: 14 interactive view modes (Grid, Stats, Events, Populations, Communication, etc.)
- Web Interface: Modern, responsive web UI with real-time updates
- Multi-zoom Viewport: Navigate and explore the simulation world at different scales
- Comprehensive Statistics: Track evolution, behaviors, tools, and environmental changes
The EvoSim web interface provides a real-time view of the evolving ecosystem with interactive controls and detailed information panels.
Watch entities interact in real-time as they move through different biomes, gather resources, and evolve their behaviors.
Track population dynamics, genetic traits, and evolutionary trends with comprehensive statistical displays.
Explore individual species with detailed trait analysis, cellular structure visualization, and interactive species galleries.
Examine organisms at the cellular level with blocky, Minecraft-style visualizations showing organelles and cellular complexity.
Explore the world's terrain features with enhanced topographic maps showing elevation, underground structures, and environmental details.
# Clone the repository
git clone https://github.com/GoCodeAlone/EvoSim.git
cd EvoSim
# Run with CLI interface
GOWORK=off go run .
# Run with web interface
GOWORK=off go run . --web --web-port 8080# Start simulation with custom parameters
GOWORK=off go run . --pop-size 50 --width 200 --height 200
# Save simulation state
GOWORK=off go run . --save my_simulation.json
# Load saved state
GOWORK=off go run . --load my_simulation.json
# Run web interface
GOWORK=off go run . --web
# Show all options
GOWORK=off go run . --help- Space: Pause/Resume simulation
- V: Cycle through view modes
- Arrow Keys: Navigate viewport
- +/-: Zoom in/out
- ?: Toggle help screen
- Q: Quit
- Access via browser at
http://localhost:8080 - Real-time simulation updates
- Interactive view switching
- Responsive design for all devices
- DNA/RNA System: Complete nucleotide sequences with realistic inheritance
- Cellular Complexity: 8 cell types and 8 organelle types
- Macro Evolution: Species trees and phylogenetic tracking
- Environmental Pressure: Natural selection based on environmental conditions
- Resource Competition: Limited food sources and territory
- Predator-Prey Relationships: Dynamic population balancing
- Communication Systems: 6 signal types for entity coordination
- Seasonal Variation: Changing environmental conditions affect survival
- Tool Discovery: Entities naturally discover tool-making based on intelligence
- Social Learning: Cooperative entities learn behaviors from others
- Environmental Adaptation: Entities modify their environment for survival
- Cultural Evolution: Behaviors spread through populations over time
- Grid: Main simulation visualization with entities, plants, and environment
- Stats: Population statistics and trait distributions
- Events: World events and significant occurrences
- Populations: Detailed population analysis and demographics
- Communication: Signal activity and communication patterns
- Civilization: Tribal structures and technology development
- Physics: Physics simulation state and forces
- Wind: Wind patterns and pollen dispersal
- Species: Species tracking and genetic distance analysis
- Network: Underground plant network visualization
- DNA: Genetic sequences and inheritance patterns
- Cellular: Cell types and organelle development
- Evolution: Macro evolution tracking and phylogenetic trees
- Topology: World terrain and geological features
# Run all tests
GOWORK=off go test ./...
# Run with verbose output
GOWORK=off go test -v ./...
# Test web interface functionality
./test_web_interface.sh
# Run benchmarks
GOWORK=off go test -bench=.- World: Main simulation manager and update loop
- Entities: Individual organisms with genetic traits and behaviors
- Plants: Plant ecosystem with reproduction and networking
- Tools: Tool creation, usage, and modification system
- Environment: Environmental modifications and persistent structures
- Communication: Signal-based entity communication
- Civilization: Tribal organization and structure building
- DNA System: Genetic representation with chromosomes and alleles
- Cellular System: Cell specialization and organelle development
- Behavior System: Emergent behavior discovery and social learning
- Network System: Underground plant communication networks
- Wind System: Atmospheric simulation with pollen dispersal
- Physics System: Collision detection and environmental forces
- Tool Making: Intelligent entities discover stone tool creation when needing better equipment
- Tunnel Networks: Entities in dangerous areas learn to dig protective underground passages
- Resource Caching: Entities hide food supplies for later retrieval during scarcity
- Trap Setting: Aggressive entities learn to set traps near food sources
- Cooperative Building: Groups work together to create complex structures
- Social Learning: Successful behaviors spread through cooperative populations
- Biomes: Grassland, forest, desert, mountain, lake, and river environments
- Weather: Storms, volcanic eruptions, earthquakes affecting evolution
- Seasonal Cycles: Spring/summer/autumn/winter with varying conditions
- Plant Networks: Underground fungal networks connecting compatible plants
- Wind Dispersal: Realistic pollen movement and cross-pollination
- Geological Events: Terrain changes affecting population distribution
--width,--height: World dimensions--pop-size: Initial population size per species--seed: Random seed for reproducible results--web: Enable web interface mode--web-port: Web server port (default: 8080)--save: Save simulation state to file--load: Load simulation state from file
Most simulation parameters can be adjusted in the source code:
- Mutation rates and genetic diversity
- Environmental conditions and biome distributions
- Tool creation requirements and effectiveness
- Behavior discovery rates and learning parameters
- Communication signal strengths and ranges
This simulation represents a comprehensive evolutionary ecosystem with:
- ✅ Complete genetic algorithm implementation
- ✅ Multi-species ecosystem with realistic interactions
- ✅ Tool creation and environmental modification systems
- ✅ Emergent behavior discovery and social learning
- ✅ Real-time web interface with WebSocket updates
- ✅ Complete state persistence functionality
- ✅ Extensive test coverage and validation
See FEATURES.md for detailed implementation status and roadmap.
This project demonstrates advanced evolutionary simulation concepts. Feel free to:
- Experiment with parameters and configurations
- Add new tool types or environmental modifications
- Implement additional emergent behaviors
- Enhance the web interface with new visualizations
- Improve genetic algorithms and selection mechanisms
This project is available for educational and research purposes. See the repository for license details.