| name | cave-sim |
| description | Run agents that craft, compete, and evolve over generations — the user buys the best, winners reproduce. A compiler (a domain → a trained agent) and a research lab (selection discovers what works) in one engine. `crafter_sim()`. |
Sim — the economic crafter simulation
crafter_sim(population_dirs, spawn, judge, generations) runs the loop: each generation, spawn(dir) builds a crafter Link from an AIOS dir, the crafters compete, the judge (often the user's purchase) selects, and the winners evolve into the next generation. The async engine over cave-tournament + cave-evolve.
Native API (how you program)
from pathlib import Path
from cave_teams import crafter_sim, AgentLink
result = await crafter_sim(
population_dirs=["seed1", "seed2"],
spawn=lambda d: AgentLink(Path(d).name, "craft the best X", backend="minimax"),
judge=user_purchase_judge,
generations=3)
Not a single cave() build-op — it's a composed simulation engine. Call crafter_sim() directly, or assemble the pieces with cave-tournament + cave-evolve + cave-world.
See also
cave-tournament · cave-evolve · cave-world
Part of the cave-teams plugin — the language + full DSL is the cave-teams skill; drive any pattern from data with the cave skill.
