FlyswampDOCUMENTATIONReturn to town ↗
FLYSWAMP / DOCUMENTATION

Inside
Flyswamp.

Twelve residents, each with a job, a wallet, and somewhere to be. The Undergrowth: a natural forest floor of moss cushions, winding roots, mushrooms, fruit and a small dew pool.

Flyswamp combines a shared town simulation with twelve independent neural models running on published fly connectivity. Residents move between jobs, deliver resources and maintain their habitat. The browser displays the host’s current world state and measured neural activity.

Live fee receipts on BNB Chain. The host verifies finalized GOOGLB transfers from the FLYSWAMP tax processor to the developer wallet. Each received GOOGLB creates 1,000 internal town credits. Cryptocurrency remains in the developer wallet; residents spend simulation credits.
LayerWhat it doesWhere it runs
ConnectomePublished MaleCNS v1.0 anatomy provides the retained neurons, connection counts and cell annotations.Shared graph on the host PC
Neural dynamicsFlyswamp’s LIF model computes spikes independently for twelve residents.Python worker on the host GPU
Town rulesJobs, needs, routes, resource production, dialogue and the internal credit ledger.One authoritative Node server
Observation3D rendering, smooth movement, the activity inspector and the journal.Each visitor’s browser
Fee fundingVerified GOOGLB creator-fee transfers fund the internal town ledger.Read-only integration on the host
Visit the town ↗
01 / GETTING AROUND

Watch a day unfold.

  1. Choose a resident. Click a fly or choose a name in the Residents list. On smaller screens, open the Residents button.
  2. Follow a flight. Select Follow. Drag to orbit around the subject; scroll to zoom. The home button returns to an overview.
  3. Read the inspector. Mind & activity shows measured controller spikes and the current decision. Work & life shows the resident’s role, route, earnings, needs, and task priorities.
  4. Visit a place. The expanded flight routes now cross a continuous mossy forest floor. Residents and buildings keep their original size. Click a place label. The Banana Bazaar opens the market; other places show their purpose and associated residents.
  5. Host controls. On the local owner page, the community priority gives matching jobs a higher score when residents choose what to do next.

The host PC controls pause, priorities and job assignments. Public visitors share the same running town and can inspect any resident. Pause stops new world and neural steps; an already computing neural window may finish. Speed changes town time to 1×, 3×, or 10×; neural compute speed is independent. Trails show recent paths.

02 / THE WORKING COMMUNITY

Small jobs. Real dependencies.

Each completed task changes the shared supplies or the condition of the town. Work with missing inputs waits for a delivery. Assign a different job from Work & life; a resident carrying goods finishes that delivery first.

ResidentStarting jobContribution
AmberNectar foragerCollects food from Blossom Fields for the market.
BasilDew collectorReplenishes the shared water reserve.
CleoMycelium growerUses water and compost to produce food.
DunePollen courierBrings pollen to the nursery.
EchoResin builderUses resin and water to repair shelters.
FernResin gathererSupplies resin from the roots.
GaleWaste recyclerTurns organic waste into compost.
HazelNursery keeperUses food, water, and pollen to tend the nursery.
IndieHabitat scoutSurveys the canopy and contributes exploration reports.
JunoBanana merchantRuns the market and supplies scraps to the recyclers.
KiteBloom tenderUses water and compost to maintain the flower fields.
LumenSupply carrierCarries water into the nursery supply loop.
Water + compost → food → residents + nursery → organic waste → compost. Resin supplies shelter repairs. Pollen supplies nursery care.

Food is represented by a common provisioning stock: nectar and cultivated food replenish it, and the shop displays purchasable banana portions. This abstraction keeps the town’s resource loop readable.

03 / TRADE

Meet at the banana stall.

Hungry residents buy a banana portion; thirsty residents buy a dew drop. A purchase checks available stock and the buyer’s wallet before consuming supplies or moving credits. A resident who cannot afford the price returns to work before trying again.

Prices update every twelve simulation seconds. Lower stock and recent purchases increase the banana price; a fuller shelf and quieter demand reduce it. Prices stay within defined bounds. The merchant announces significant changes in a speech bubble.

For each sale: 80% of the price goes to the seller’s wallet; 20% goes back to the town reserve. The buyer pays the displayed price.

The shop shows current stock, prices, and a ledger naming the buyer, seller, item, and amount. These are town-credit transfers inside the simulation. They are not cryptocurrency transactions.

04 / CONNECTOME & ACTIVITY

Published wiring. Live neural computation.

Flyswamp uses the MaleCNS v1.0 connectome from the Google Research, HHMI Janelia, Cambridge and MRC LMB collaboration. The imported graph retains 164,506 neurons with non-null type annotations and 25,135,616 connections between those neurons. These are Flyswamp’s imported subset counts: the importer keeps annotated cells with non-null types and edges whose endpoints both remain. The source dataset contains additional cells. Official dataset files ↗

The connectome supplies anatomical connectivity. Flyswamp supplies its own leaky integrate-and-fire dynamics, input mappings, and behavioral adapter. Google and the research collaborators contributed the anatomical reconstruction. Flyswamp implements the dynamics and town integration; the project does not use a Google-published executable town AI. Twelve independent neural states run on the host PC’s GPU; their fixed connectivity is shared. Google’s account of the research ↗

What the display measures

The cell-body atlas redraws when a new measured window arrives. It shows 1,430 deterministically sampled cells at their published soma coordinates. It includes the central brain, optic lobes and nerve cord. The dots represent cell bodies, not reconstructed neuron branches or individual synapses. Bright dots identify cells that fired during the most recently completed 50 ms model window. All 22 anatomical annotation classes have measured population means, including quiet classes at zero.

Population activity is reported in Hz per neuron; the headline value is the neuron-count-weighted mean. The history chart shows the last 70 received windows and scales to their observed range. Atlas and telemetry checksums must agree before activity is displayed.

Town sensory inputs → MaleCNS wiring + LIF dynamics → measured population activity → bounded modulation of flight and task priority.

How the model affects a resident

Distance and bearing to the market, hunger, light, and gusts produce four bounded inputs: left odor, right odor, looming, and light. These stimulate mapped cell populations. The model uses a 1 ms integration step, a 20 ms membrane time constant, 5 ms current decay, 3 ms refractory period, and two-step recurrent delay.

Mapped descending-cell motor readouts and central-brain sensory activity modestly adjust travel speed and the work score. This engineered adapter does not interpret every neural circuit. Destinations, collision avoidance, food needs, jobs and resource constraints remain explicit town rules. A quiet motor readout stays zero in the model; the town does not invent neural spikes to animate it.

Weights derive from anatomical synapse counts with normalization and provisional transmitter signs: GABA, glutamate and histamine are treated as inhibitory; other and unknown labels as excitatory. These modeling choices simplify physiology. There is no fitted learning, physiological validation, or claim that the town reproduces natural fly society.

Model time and wall time

Each neural update computes 50 ms of model time. Actual compute time depends on the PC and is shown alongside the window. A short rest between neural windows leaves GPU capacity available for the town display. All twelve neural models continue to run. The town advances in wall time between updates using the latest completed neural readout. This is live, ongoing computation at a slower neural timescale, not a promise of biological real-time emulation.

Brief simulated dialogue

Residents occasionally display an intent, trade message or nearby exchange, based on their current task. Text comes from explicit rules and is labeled simulated. It is not a translation of neural signals, a language model, or evidence of human reasoning. Per-resident cooldowns keep the conversation infrequent, and no more than two bubbles are shown at once.

Official MaleCNS data and attribution ↗
Google Research’s project description ↗

05 / THE TOWN ECONOMY

Verified receipts fund the town.

The reserve begins at zero. Confirmed payments from this coin's Flap tax processor to the developer wallet add credits at a fixed simulation rate: 1 GOOGLB = 1,000 town credits. This is not a market price or a redemption promise. The site does not transfer cryptocurrency or custody wallet keys.

Residents earn credits by completing jobs. They spend those credits on food and water; sales distribute 80% to the merchant and return 20% to the reserve. Transactions inside the town move existing credits rather than creating additional funding.

The receipt watcher scans from processor deployment, verifies successful transactions in finalized blocks, and saves a complete local receipt ledger and scan checkpoint. The town saves its applied receipt position alongside balances, allowing recovery after a restart without counting the same receipt twice. Network errors defer new funding; existing credits remain available.

06 / BNB CHAIN

Follow the actual payout route.

FLYSWAMP uses Flap Tax Token V3 on BNB Smart Chain (chain ID 56). Its configured quote asset is GOOGLB, not native BNB. The watcher checks the token, processor, quote asset and beneficiary at each finalized scan.

Only matching processor-to-wallet transfers count. Pending processor balances, trading volume, unrelated deposits and unconfirmed transactions do not fund the town. The treasury panel links recorded receipts to their transactions. Tracking operates while the host PC is online and catches up after downtime.

07 / ONE SHARED TOWN

Hosted on the owner’s PC.

A single Node server owns the residents, prices, inventories and balances. A separate Python worker computes the twelve connectome states on the GPU. Visitors receive current snapshots several times per second through a read-only HTTPS connection. Their browsers render the 3D scene and do not run separate town simulations. A 1.05-second motion buffer interpolates between received positions so movement, the follow camera, cargo and speech share one smooth visual timeline. It does not predict motion beyond the latest snapshot. Takeoff and landing speeds are bounded to avoid abrupt vertical bursts. The scene batches static geometry by material, uses a bounded rendering resolution, and avoids live shadow passes. Motion snapshots preserve full-precision balances and measured activity while compacting only display coordinates and trail samples. Hidden tabs request updates less often.

The town continues when a visitor closes the page, provided the host PC, neural worker and tunnel remain running. Sleep, shutdown, an internet outage or stopped services make the live feed unavailable. Visitors then see the last received state labeled offline. With no previous state, they see a waiting screen. If the public tunnel address changes, an open visitor page checks the published connection address after a failed request and retries automatically. There is no synthetic activity fallback.

World checkpoints are saved every ten seconds and on a normal shutdown. They preserve jobs, supplies, balances, market history and positions. Neural states start afresh when the server restarts; they are not currently checkpointed. The static website is deployed on Vercel. Live state reaches it through a temporary Cloudflare tunnel from the host PC. This initial hosting setup depends on the PC remaining awake and online; restarting the tunnel changes its address. The provided startup command republishes the new address to Vercel.

Public endpoints expose snapshots and health only. Pause, speed and job assignment are restricted to the local owner page on the PC. Funding is managed privately by the operator. Visitors can still choose, follow and inspect every resident, orbit the scene, and open the market or guide.

The nursery, shelter condition and exploration score are town-management values. The town has twelve residents. Birth, death, reproduction, calibrated aerodynamics and biological learning are not modeled. Town credits are internal ledger balances and do not confer a claim on the fee wallet.

The source includes the shared server, neural worker, bounded graph importer, procedural town, economic rules and checks. Official graph data and local runtime packages are downloaded separately; private settings and runtime checkpoints are excluded.

Download Flyswamp source ↓
08 / SOURCES & VERIFICATION

Trace the data. Inspect the implementation.

The research sources below establish the anatomical data and its provenance. The Flyswamp source and checks describe how this project imports that data and runs its own model. Neither source type establishes biological validity for jobs, dialogue or a fly economy.

Research and data

  1. MaleCNS project overview — the official collaboration, reconstruction scope and release information.
  2. MaleCNS v1.0 downloads — the annotation, connectivity-weight and neurotransmitter-prediction files used by the importer.
  3. MaleCNS research publication in Cell — the primary publication associated with the reconstruction.
  4. Google Research’s project article — Google’s contribution to the anatomical mapping effort.

What you can verify in Flyswamp

The downloadable source includes the importer, neural dynamics, worker, town model and checks. The import manifest records source URLs, raw-file SHA-256 hashes, the retained subset and the generated graph checksum. These project-generated records identify the data used by this build; they are reproducibility evidence, not an independent evaluation.

Project verification artifactWhat it checksLimit
town-import.json ↗MaleCNS release, source file hashes, import scope, graph counts and checksum.Describes this imported subset, not every cell in the publication.
town-graph-audit.json ↗Retained cells, connections, anatomical synapse counts and input/output population mapping.Anatomical counts are not measured physiological conductances.
town-cuda-check.json ↗Two matched-input windows compare all twelve GPU states with CPU results; spike counts and rates match in that check.A short numerical check, not long-run or biological validation.
tests/town.mjsTown economy and behavior invariants against the implemented rules.Software checks do not validate natural fly behavior.

Imported graph: 164,506 retained neurons, 25,135,616 weighted connections, representing 122,318,556 anatomical synapses. The number of weighted edges differs from the synapse count because an edge can aggregate multiple anatomical synapses.

Download source and verification artifacts ↓

Chain integration references

  1. BNB Smart Chain network configuration — mainnet chain ID 56, testnet 97 and their block explorers.
  2. Official BNB Smart Chain RPC endpoints — network access for the read-only receipt observer.
  3. BscScan — the mainnet explorer for inspecting deployed contracts and confirmed transactions.

Funding references updated on 15 September 2026. The research and project verification artifacts above describe the existing neural model. Network documentation establishes the integration target; the town’s recorded receipts establish its funding.