Agent societies that vote, remember, and specialize—unsupervised
Ava runs thousands of autonomous agents in a shared world to see if statistically significant civilization—laws, roles, alliances—emerges from local rules alone.
A research framework runs thousands of autonomous agents in parallel to see what civilization-level behaviors emerge from local rules—and ties it all to a token called $AVA.

What it does
Ava is a headless Python framework for running hundreds to thousands of autonomous agents in a shared environment. Each agent owns a tiered memory system, a belief model, and a social graph, stepping through a perceive-deliberate-act loop every tick. The goal is to watch civilization-level properties—specialized roles, shared norms, emergent laws—arise from local interactions without being scripted in advance.
The interesting bit
Rather than trusting a demo video to prove emergence, Ava ships an analysis layer that runs Mann-Whitney U change-point detection over rolling population metrics, turning “it looks like they formed a government” into a statistically backed claim with a p-value.
Key highlights
- Memory is split into episodic, semantic, and procedural stores with distinct retrieval and decay rules; successful skills reinforce independently of any single episode.
- Ticks are scheduled via
asyncio.TaskGroupunder a bounded semaphore, so populations scale without unbounded coroutines or one slow agent freezing the world. - Agents can propose and vote on laws through a
GovernanceSystemwhose quorum scales with population, and a three-phase BFT consensus protocol handles adversarial participants. - A reference dashboard inspects live agent state, memory, and relationships, built on
SimulationTracerso the core engine stays frontend-agnostic. - Benchmarks show throughput holding around 20–25k agent-steps per second for populations up to 5,000.
Caveats
- The README truncates its own performance table mid-line, leaving the 5,000-agent p95 and exact throughput incomplete.
- The consensus module is named
RaftLikeConsensusbut implements a PBFT-style three-phase commit, which may mislead readers searching for actual Raft logic.
Verdict
Worth a look if you are building large-scale social simulations or multi-agent reinforcement environments and need statistical rigor around emergence. Skip it if you just want a quick LLM chatbot wrapper—this is a systems framework, not a conversational agent.
Frequently asked
- What is TianhangZhuzth/Fundamental-Ava?
- Ava runs thousands of autonomous agents in a shared world to see if statistically significant civilization—laws, roles, alliances—emerges from local rules alone.
- Is Fundamental-Ava open source?
- Yes — TianhangZhuzth/Fundamental-Ava is open source, released under the Apache-2.0 license.
- What language is Fundamental-Ava written in?
- TianhangZhuzth/Fundamental-Ava is primarily written in Python.
- How popular is Fundamental-Ava?
- TianhangZhuzth/Fundamental-Ava has 602 stars on GitHub.
- Where can I find Fundamental-Ava?
- TianhangZhuzth/Fundamental-Ava is on GitHub at https://github.com/TianhangZhuzth/Fundamental-Ava.