whatisgithub

What is evo-parliament?

nulllabtests/evo-parliament — explained in plain English

Analysis updated 2026-05-18

0PythonAudience · researcherComplexity · 5/5LicenseSetup · moderate

In one sentence

A research framework simulating self-governing AI agent groups that vote to evolve their own rules, guided by a biologically inspired memory system and tested across several voting methods.

Mindmap

mindmap
  root((evo parliament))
    What it does
      Self governing agents
      Constitutional voting
      Hebbian memory
    Tech stack
      Python
    Use cases
      Compare voting methods
      Measure open-ended evolution
    Audience
      Researchers
      AI governance study

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Run experiments comparing how different voting methods affect a self-governing multi-agent system's long-term complexity.

USE CASE 2

Study how a Hebbian-inspired memory system changes what agents propose and vote for over time.

USE CASE 3

Use the included metrics to measure open-ended evolution, like diversity and complexity growth, in a multi-agent simulation.

What is it built with?

Python

How does it compare?

nulllabtests/evo-parliament0xhassaan/nn-from-scratch3ks/embedoc
Stars00
LanguagePythonPythonPython
Last pushed2023-06-08
MaintenanceDormant
Setup difficultymoderatemoderatehard
Complexity5/54/51/5
Audienceresearcherdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 1h+

Requires Python 3.10+ and is built for running research experiments, not a plug-and-play tool.

MIT license: free to use, modify, and share, including for commercial purposes, as long as the copyright notice is kept.

So what is it?

This project is a research framework for simulating groups of AI agents that govern themselves. Instead of following fixed rules set by a human designer, the agents in this system propose changes to their own rulebook, debate them, and vote on whether to adopt them, so their constitution evolves over time through the group's own decisions. Each agent also carries a kind of associative memory inspired by how biological brains strengthen connections between things that occur together, called Hebbian memory. This memory quietly influences what an agent proposes and how it votes in future rounds, based on what has worked or failed before. On top of the voting and memory system, the agents also evolve genetically across generations. Agents with better reputations and whose behavior lines up well with the group's shared memory are more likely to pass their traits on to the next generation, similar to natural selection. All of this plays out inside a simplified simulated chemistry environment, where simple abstract molecules interact according to fixed mathematical rules. The point of this environment is to give the group's governance decisions real, measurable consequences, such as how complex, diverse, and energy sustainable the resulting system becomes over time. The authors tested four different voting methods, including simple majority rule, quadratic voting, conviction voting, and liquid democracy, running each one many times. They report that quadratic voting produced the most open ended, increasingly complex outcomes by a wide margin, and that adding the Hebbian memory system meaningfully improved outcomes compared to a version without memory. The project is aimed at researchers studying self governing multi agent systems, constitutional AI, and artificial life, and is built as a reproducible experimental framework rather than a ready to use product. It is written in Python and requires Python 3.10 or newer.

Copy-paste prompts

Prompt 1
Explain how the parliament in this repo lets agents propose and vote on changes to their own constitution.
Prompt 2
Walk me through the difference between majority, quadratic, conviction, and liquid voting as implemented here.
Prompt 3
Help me set up a simulation run and interpret the OEE metrics it produces.
Prompt 4
Show me how Hebbian memory in agent.py influences an agent's future votes.

Frequently asked questions

What is evo-parliament?

A research framework simulating self-governing AI agent groups that vote to evolve their own rules, guided by a biologically inspired memory system and tested across several voting methods.

What language is evo-parliament written in?

Mainly Python. The stack also includes Python.

What license does evo-parliament use?

MIT license: free to use, modify, and share, including for commercial purposes, as long as the copyright notice is kept.

How hard is evo-parliament to set up?

Setup difficulty is rated moderate, with roughly 1h+ to a first successful run.

Who is evo-parliament for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.