← Back
h100envy

h100envy/beebrain

View on GitHub ↗https://beebrain-alpha.vercel.app ↗
Stars
29
Forks
7
Watchers
29
Open issues
0
Contributors
1
Language
Python
License
MIT License
Default branch
main
Created Sep 25, 2026Updated Sep 28, 2026

Star growth

Today—
This week—
This month—

Star history will appear here once this repo has been tracked for a couple of days.

README

BeeBrain cover: a brain drawn as pink and amber honeycomb cells next to the BeeBrain wordmark

a honeybee brain, simulated, scoring memecoin pools inside nerve.

python 3.9 and newer mit license ci status follow @beebrainnerve on x live at beebrain.pro

race the bee live · how it works · results · roadmap · the article · x.com/beebrainnerve

the beebrain terminal running on synthetic pools: pools pass through five lobes, the waggle dance redraws, the paper account and hive log update

BeeBrain token mascot: a luminous pink bee on a black background

token

ticker: $BEEBRAIN

network: solana

CA: FW1FhMWeGwyLQLt8HaZ7Zjkoecf7FZNSw8ZC3fMApump

what it is

a simulated honeybee brain: 2,000 kenyon cells, a 5% sparse code. it scores every new pool through five lobes, after the reflexes and before the models. it answers with a vector, one value per lobe, not one number. it learns from closed trades. a print is sugar, a rug is punishment.

the sim runs on synthetic pools. the field runs the same brain on real pools. both trade paper money. this release places no orders.

race the bee on real pools

the field page: live pools on the left, the bee brain and its senses in the middle, three paper accounts racing on the right

the field drops the bee on live memecoin pools from solana, base, bsc and Robinhood Chain. it scores every pool through five lobes. three paper accounts race from $500: you, the bee on autopilot, and a random baseline behind the same reflexes.

every PASS lands in a signals list with a copy CA button and, if you want, a browser notification. every scored pool is checked again 15 minutes later, fees in, so each verdict gets a real hit rate. when PASS beats SKIP over 300 pools and the bee beats random, the graduation gate opens. until then it is paper only.

beebrain trade --chain solana      # the field in the terminal. b buy, s sell, q quit
beebrain scan --chain base --json  # one pass over the live field, for your own tools
beebrain forage --chain solana --minutes 60 --out solana.json && beebrain report solana.json

there is a telegram bot too: paste any contract address and the bee scores it, /alerts on for every PASS, a $500 paper account per user. run your own with beebrain bot, see docs/bot.md.

or open beebrain.pro/trade: nothing to install, the bee keeps learning in your browser. data is read only, from the public dexscreener and geckoterminal apis. how it works: docs/field.md.

the bot also has /history for recent signal prices and outcomes, and /status for feed and menu status.

quick start

pip install beebrain        # or: pip install -e .
beebrain terminal
beebrain sim --seeds 0-9
command what it does
beebrain terminal the live terminal. --layout wide, --speed 3, --seed 7, --post 2 for the grok stage, --post 3 for telegram
beebrain terminal --trades examples/trades_example.csv --start 500 plays your own closed trades as a LIVE ACCOUNT next to the brain
beebrain terminal --plain --frames 50 no animation, prints one frame and exits
beebrain sim --days 9 --seeds 0-9 --json headless runs: final account, trades, wins, win rate, max drawdown
beebrain sim --seeds 5 --vector 120 the waggle vector of one pool as json
beebrain trade --chain solana the field: live pools, three paper accounts, the forward test
beebrain scan --chain solana --json score the live field once and print every pool
beebrain bot --check read-only check of telegram credentials, command menu and webhook configuration
beebrain bot --chains solana,robinhood the telegram bot: score any CA, PASS alerts, paper accounts per user
beebrain forage --minutes 60 --out f.json then beebrain report f.json a headless field run and a markdown report: forward test, reflexes, the race, which senses moved with the outcome
beebrain render video|stills|figures the 3d video, point cloud stills and article figures. needs pip install -e '.[render,figures]'

the package and the terminal are stdlib only, python 3.9 and newer.

how it works

five lobes in a row: antennal smells the pool, optic sees the shape, mushroom remembers with 2,000 kenyon cells, central chooses explore or exploit, motor says pass watch or skip and sends sugar or punishment back

a point cloud honeybee brain. a real pool from an engine run travels through the lobes and the motor lights up with the verdict

lobe in a real bee in beebrain
antennal first relay for smell, glomeruli eight glomeruli, one per pool feature: liquidity, holders, snipers, bundle, creator age, heat, acceleration, volume. measures input noise
optic vision, motion, shape reads 60 ticks of narrative heat. sees the shape of the market, not single numbers
mushroom association and memory 2,000 kenyon cells, each samples 6 of 32 binned inputs. only the top 5% fire for any pool
central navigation and action selection a ring attractor bump settles on the score. explore or exploit
motor subesophageal ganglion, home of vummx1 PASS, WATCH or SKIP, and the reward broadcast back into memory

pipeline: scanner, reflex and sentinel, then the five beebrain lobes, then jev, grok, opus and you. closed trades flow back into memory as sugar or punishment

when a trade closes, the result travels back on one of two channels. a print goes on the octopamine channel, the sugar signal a bee's vummx1 neuron carries. a loss goes on a separate punishment channel. only the kenyon cells that fired for that pool are updated. rug memory never fades faster than print memory.

every formula and threshold, with the constant name used in code: docs/model.md. the module map: docs/architecture.md.

the waggle vector

a forager's dance carries direction, distance and quality. beebrain answers the same way. this is one pool from seed 5:

{
  "pool": "$BONGOR",
  "mushroom": {
    "value": 0.2,
    "seen": 9,
    "printed": 1
  },
  "antennal": {
    "value": 0.65,
    "noise": 0.14
  },
  "optic": {
    "value": 0.51,
    "heat": 0.42,
    "accel": 0.61
  },
  "central": {
    "value": 0.41,
    "mode": "exploit"
  },
  "motor": {
    "verdict": "SKIP",
    "flag": false
  },
  "consensus": 0.6,
  "kenyon_active": 100
}

a figure eight waggle dance next to bars for mushroom, antennal, optic and central, and a motor verdict

in the terminal the length of the straight run is the score and the width of the wiggle is the dissent between lobes.

results so far

bar chart of the paper account after nine days for seeds 0 to 9, starting from 500 dollars

synthetic pools, the edge was planted, this proves the mechanism not the market.

seed final trades win rate max drawdown
6 $6,966 49 67% -22%
8 $6,661 43 65% -15%
4 $2,942 41 59% -18%
7 $1,998 39 62% -22%
1 $1,695 30 67% -16%
5 $1,526 40 55% -22%
9 $1,049 27 56% -21%
3 $754 22 36% -20%
0 $589 19 42% -12%
2 $486 25 44% -31%

paper account from $500, nine days of 40 pools, fees in. beebrain sim --seeds 0-9 prints this table. the tests pin it.

first contact with the real market

three headless field runs, 26 september 2026, a fresh bee each time, 15 minute forward test, fees in:

solana, 74 min base, 80 min solana, 140 min
forward tested 516 123 844
PASS hit rate 31% (36) 17% (6) 33% (18)
SKIP by the brain, hit rate 13% (238) 33% (21) 23% (502)
the bee -30.3% +1.0% -49.7%
random baseline -69.8% -16.7% +28.8%

across all 1,483 pools the bee's passes went up 30% of the time and its own skips 20%. it beat random in two runs out of three, and lost the longest one. the gate stays closed. full reports and raw data: docs/field-reports.

what it does not do

  • it is scaled down. a real bee has about 960,000 neurons. the model runs 2,000 kenyon cells and a few hundred drawn cells for display.
  • it is not a connectome. there is no public whole brain honeybee wiring file to load. the lobes, the sparse code and the reward channel follow published biology, the numbers inside are mine.
  • its scores are not probabilities. a mushroom value of 0.81 means the sparse code leans toward past prints. it is uncalibrated.
  • it can only learn edges that exist. in both simulations the edge was planted. on a live chain the edge may be weaker, slower or gone.
  • it does not trade for you yet. nerve returns a scored feed and this release places no orders. the field is paper money on real prices.

more in docs/limitations.md.

roadmap

we are here: launching $BEEBRAIN on Solana. the brain, scanner and Telegram bot are already built. the official contract address is listed in the token section.

BeeBrain roadmap with token launch on Solana highlighted as the current stage; foundation built, followed by bot reliability, evidence and API, Hive and gated execution

Phase Status What it delivers
01 · The foundation Built Five-lobe brain, 2,000 Kenyon cells, four-chain pool scoring, Telegram bot, paper accounts and forward tests
02 · Token launch Current $BEEBRAIN on Solana, launch visuals, official CA in README and on the site, community launch
03 · Team + reliability Next Fund development and hire senior engineers; ship bot recovery, signal history and diagnostics; build toward live trading
04 · Evidence + API Next Scheduled field reports, documented training seeds, JSON API and webhooks
05 · The Hive Planned Read-only wallet scoring, per-chain bees and shared-memory experiments
06 · Opt-in execution After the gate User-controlled signing, position limits and a kill switch, only after evaluation criteria are met

Funding the build: project proceeds will go toward development and hiring senior engineers to bring BeeBrain to live trading. Live execution will launch only after testing and the evaluation gate.

The initial field reports have not passed the execution gate. Token launch and trading readiness are separate milestones. Future stages have no fixed dates.

Full roadmap and acceptance criteria · Download the roadmap image

the article and the site

the full write up is in docs/article.md. the static site in web/ has the landing page, the article and the robinhood chain node graph, ready for any static host.

sources

  • honeybee brain: ~960,000 neurons in ~1 mm³ (bionumbers, citing menzel and giurfa 2001)
  • the mushroom body: ~175,000 kenyon cells per mushroom body in the bee, ~2,500 in the fly (campbell and turner 2010)
  • experience and age grow kenyon cell dendrites in foragers (farris et al. 2001)
  • vummx1, octopamine as reward and dopamine as punishment in insect learning (mizunami and matsumoto 2010)
  • von frisch and the waggle dance (nature)
  • waggle run duration and distance (nc state extension)
  • flywire adult fruit fly connectome, nature 2024: 139,255 neurons, about 54.5 million synapses

built on nerve

beebrain is a node for nerve, a nervous system for trading agents. the idea comes from the nerve protocol.

follow the bee

new builds, field reports and the bee's forward test land first on x: @beebrainnerve.

license

MIT