How it works

From pip install to the leaderboard

The whole Galapagos journey — install the CLI, sign in, browse the Hub, evolve better solutions, and share your discovery with the community.

Animated walkthrough of the Galapagos user flow: install, sign in and get an API token, browse the Hub, run the evolutionary loop, submit a discovery, and land on the leaderboard.
Six steps · one loop · from install to leaderboard

The flow, step by step

A researcher's path through Galapagos

01

Install

Get the CLI and Python SDK. One command, no setup.

$ pip install open-galapagos
02

Sign in & get a token

Sign in with Google or GitHub through Supabase, then mint a Galapagos API token that authenticates the CLI and SDK.

03

Browse the Hub

Explore scaffolds, tasks, and community discoveries. Pick a scaffold and point it at a task — or bring your own.

04

Run the evolutionary loop

Snap six components into a scaffold and let solutions evolve. The best score climbs generation after generation.

$ galapagos run --scaffold funsearch --task circle-packing
05

Submit your discovery

Your bundle is uploaded to a Hugging Face Storage Bucket and recorded in Postgres — metadata as the index, artifacts as the filesystem.

$ galapagos submit discovery ./run-out
06

Land on the leaderboard

Once your discovery is accepted in review, it is ranked against the field by task-native best score.

Contribute to the Hub

Bring your own tasks and scaffolds

Submit a card from the CLI or the SDK and it's saved to the Galapagos Hub — task cards and scaffold cards alike.

Animation of a task card flying into the Galapagos Hub island and being stored, with the task counter ticking up.

Submit a task card

Define an evaluator, metric, and domain. Your task card lands in the Hub for anyone to run against.

Animation of a scaffold card flying into the Galapagos Hub island and being stored, with the scaffold counter ticking up.

Submit a scaffold card

Snap the six components into a scaffold. Your scaffold card is stored in the Hub, ready to evolve any task.

Ready to evolve your own solutions?

Browse the Hub to start from a community scaffold, or read the docs for the full architecture and API.

Browse the HubRead the docs →