git404hub

what is serenissima-harness fr?

mariocasanovacf/serenissima-harness — explained in plain English

Analysis updated 2026-05-18

3PythonAudience · researcherSetup · hard

tl;dr

An experimental multi-agent AI coordination system, inspired by Venice's council-based government, where several AI agents share tasks instead of one model doing everything.

vibe map

mindmap
  root((serenissima))
    What it does
      Multi agent coordination
      Venice council model
      Shared task board
    Tech stack
      Python
      Claude Code
      Gemini
      Codex
    Use cases
      Agent orchestration
      Research reference
      Task delegation
    Audience
      Researchers
      Multi agent builders

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 make with this?

VIBE 1

Coordinate multiple AI coding agents on the same project without them overwriting each other's work

VIBE 2

Study research papers and reference implementations on multi-agent AI orchestration

VIBE 3

Set up a shared task board that lets a lead AI agent delegate work to specialist agents

VIBE 4

Experiment with running the same coordination setup across Claude, Gemini, and Codex

what's the stack?

PythonClaude CodeGeminiCodex

how it stacks up fr

mariocasanovacf/serenissima-harness0marildo/imago0xdfi/glm-5.2-1m-4x-dgx-spark
Stars333
LanguagePythonPythonPython
Setup difficultyhardeasyhard
Complexity2/55/5
Audienceresearchergeneralresearcher

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

how do i run it?

Difficulty · hard time til it works · 1day+

Requires understanding multiple AI CLI tools and a custom coordination layer before anything runs.

in plain english

This repository is a research workspace for building what its author calls a Universal Agent System, a setup where several AI agents work together on tasks instead of one AI model doing everything alone. The design is inspired by the historical Republic of Venice, where decisions were never made by a single ruler but through a group of councils working together. The workspace holds several kinds of material. There are written specification files that describe how the system should behave for different AI models, including Claude and Gemini. There is a folder of research papers, downloaded as PDFs, that the project draws ideas from, covering topics like coordinating many AI agents at once and building systems that can observe and improve themselves over time. There are also copies of other people's reference code that the project studies and builds on. The project describes a runtime layer that keeps track of ongoing work through a shared status file, task details, locks that prevent two agents from working on the same thing at once, and logs for reviewing what happened. It also includes integration folders for using this system directly inside Claude Code, Gemini, and Codex, each with their own agent roles such as a planner, a worker, and a verifier that checks the work. A coordinating AI agent is meant to read the main documentation first, then check the current status of the shared task board, and hand out available work to the other agents rather than doing every step in order by itself. Changes to the core specification files are meant to go through a review step rather than being made directly. This is an early-stage, experimental research project with very few stars, aimed at people already comfortable running multi-agent AI setups rather than newcomers. No license is stated in the README.

prompts (copy fr)

prompt 1
Explain how the Venice-inspired council idea maps onto this multi-agent coordination system
prompt 2
Walk me through how the shared task board and locks prevent two AI agents from conflicting
prompt 3
Summarize the research papers referenced in this project and what each contributes
prompt 4
Show me how to set up this coordination system for Claude Code on a new project
prompt 5
Compare the planner, worker, and verifier agent roles described in this repository

Frequently asked questions

what is serenissima-harness fr?

An experimental multi-agent AI coordination system, inspired by Venice's council-based government, where several AI agents share tasks instead of one model doing everything.

What language is serenissima-harness written in?

Mainly Python. The stack also includes Python, Claude Code, Gemini.

How hard is serenissima-harness to set up?

Setup difficulty is rated hard, with roughly 1day+ to a first successful run.

Who is serenissima-harness for?

Mainly researcher.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.