Project Cambrian — The Biological Sandbox

Project Cambrian is a premium desktop digital terrarium and evolutionary simulation application. Built on top of the Biologically Inspired Brain (BIB) substrate, it serves as a visual playground to observe, interact with, and evolve autonomous artificial lifeforms in real-time.

Designed as a fully self-contained application, Cambrian packages a high-performance Python FastAPI simulation server (as a frozen, low-overhead binary) and a responsive React user interface inside a lightweight Electron shell. It runs entirely locally on consumer hardware without any external dependencies.

Core Features

• Real-Time Brain Inspection: Click on any digital organism or predator (wolf) in the ecosystem to view a live visualization of its internal brain states. Trace their active synaptic connections, see their current neurochemical metrics (Dopamine, Acetylcholine, Serotonin, Cortisol), and inspect their automatically generated autobiographical biographies.
• Worldbox-Style Terrain Painting: Act as the Director of the ecosystem. Paint dynamic tiles including Grasslands, deep Water, sandy Shores, rocky Obstacles, and dense Forests. Different terrain types interact directly with resource spawning rates and organism navigation.
• Environmental Catastrophes and Seasons: Evolve your species under pressure. Trigger dynamic seasonal shifts (lush springs, hot summers, dry autumns, and freezing winters) or trigger sudden catastrophes such as Droughts (drying up water sources), Ice Ages (freezing water and blocking movement), or Wildfires to test the limits of natural selection.
• Director Sandbox Controls: Manually spawn ancestor organisms with custom physical features, place wolves to introduce predation pressure, adjust environmental mutation rates, change simulation speeds, or selectively zap organisms to guide the evolutionary path.
• Cross-Session Binary Serialization: Save and load your terrariums instantly. Cambrian utilizes fast, lightweight binary pickle serialization to freeze the exact state of all tile maps, organism histories, and neural weight matrices, accompanied by small JSON metadata sidecars for instant saves scanning.

System Architecture

Cambrian is built on a highly modular decoupled architecture:

• The Engine (Backend): A compiled, multiprocessing-safe Python binary running a high-speed simulation loop. It manages the physical 2D sandbox grid, runs agent navigation and resource calculations, handles genetic crossover, and runs the full BIB neural substrate for every living organism.
• The Interface (Frontend): A high-performance React application utilizing CSS Grid, Canvas, and WebSockets to stream states at 30Hz with micro-second latency.
• The Shell (Electron): Coordinates the startup lifecycle, automatically booting and binding the backend binary to local port 8000 before rendering the interface, ensuring a single-click desktop experience.

Download and Release

Project Cambrian is currently distributed as a desktop installer for Windows: