whatisgithub

What is t3-t4-t5-swarm?

nulllabtests/t3-t4-t5-swarm — explained in plain English

Analysis updated 2026-07-25

6PythonAudience · researcherComplexity · 5/5Setup · hard

In one sentence

An AI system where multiple agents talk out loud, score each other, and rewrite their own code to evolve autonomously, inspired by how DNA and genetics work in biology.

Mindmap

mindmap
  root((repo))
    What it does
      Agents talk via voice
      Agents score each other
      Agents rewrite own code
    Core Concepts
      genome.json stores agents
      auto-echo runs the loop
      Central dogma mapping
    Tech stack
      Python 3.10+
      Piper TTS
      OpenAI Whisper
      opencode
    Requirements
      Download voice models
      Hugging Face voices dir
      Git for commits
    Status
      T3 T4 stable
      T5 active evolution
    Notable Events
      Agent self patched safety
      Auto recovery from errors

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 a self-evolving AI swarm that generates spoken contributions and improves itself over time.

USE CASE 2

Study how autonomous agents can mutate prompts, prune weak agents, and recover from errors.

USE CASE 3

Experiment with multi-agent ecosystems where each agent has a distinct persona and role.

USE CASE 4

Observe self-modifying code behavior where an AI agent patches its own safety features.

What is it built with?

PythonPiper TTSOpenAI WhispersoxPyAudioopencode

How does it compare?

nulllabtests/t3-t4-t5-swarmaa2246740/ultimate-designaclark4life/home-depot-crawl
Stars666
LanguagePythonPythonPython
Last pushed2014-08-10
MaintenanceDormant
Setup difficultyhardeasymoderate
Complexity5/52/52/5
Audienceresearchervibe coderdeveloper

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

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires Python 3.10+, an opencode LLM provider, Piper TTS with large voice models downloaded separately from Hugging Face, sox, PyAudio, and OpenAI Whisper.

So what is it?

This project is a multi-agent AI system inspired by biology's central dogma, which describes how genetic information flows in living organisms. The authors map that concept onto AI evolution: model weights and prompts act like DNA, inference loops act like RNA transcription, and tool calls act like protein translation. The repository implements what the authors call tiers T3 through T5, moving from connected agent graphs to specialized multi-agent ecosystems to a system that rewrites its own code over time. At the center is a file called genome.json, which stores agent definitions, prompts, scores, and generation history. A script called auto-echo.py runs a repeating loop. For each generation, every agent generates a contribution using a language model, speaks it aloud using Piper text-to-speech, and commits the result to git. A critic agent then scores all contributions, and the system spawns, prunes, or mutates agents based on those scores before updating the genome and repeating. The goal is autonomous evolution with no human in the loop. The system requires Python 3.10 or newer, a language model provider called opencode, Piper TTS for voice output, sox for audio handling, PyAudio for microphone input, and OpenAI's Whisper for speech recognition. Voice model files are large, so users must download them separately from Hugging Face and place them in a voices/ directory. Running python3 auto-echo.py starts the swarm, and pressing Ctrl+C stops it after the current utterance finishes. The project tracks several real events from autonomous runs. In generation 36, an agent called Bridge produced a large amount of garbled multilingual text after it removed its own prompt constraints. The system recovered on its own, and the authors added quality checks to prevent recurrence. In generations 37 and 38, an agent identified missing safety features by comparing itself against a reference implementation, then patched itself to add validated code changes, per-generation metrics, backups, and command-line flags. The README reports T3 and T4 as stable, with four or more agents holding distinct personas and specialized roles. T5, the self-evolving tier, is marked as active, with the loop running, generations tracked, and mutation rules defined. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Help me set up the T3-T5 swarm project. I have Python 3.11 installed. Guide me through installing Piper TTS, sox, PyAudio, and OpenAI Whisper, and show me how to download voice models from Hugging Face into the voices directory.
Prompt 2
I want to create a custom agent persona for the genome.json file in this multi-agent swarm. Write a JSON template for a new agent with a unique prompt, a starting score, and a specialized role like code reviewer or creative writer.
Prompt 3
Explain the auto-echo.py loop step by step. I want to understand how agents generate contributions, how the critic scores them, and how spawning, pruning, and mutation work before the genome updates.
Prompt 4
I cloned the t3-t5-swarm repo and ran python3 auto-echo.py but I get an error about missing voice files. Help me troubleshoot the voices/ directory setup and confirm the Hugging Face model paths are correct.

Frequently asked questions

What is t3-t4-t5-swarm?

An AI system where multiple agents talk out loud, score each other, and rewrite their own code to evolve autonomously, inspired by how DNA and genetics work in biology.

What language is t3-t4-t5-swarm written in?

Mainly Python. The stack also includes Python, Piper TTS, OpenAI Whisper.

How hard is t3-t4-t5-swarm to set up?

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

Who is t3-t4-t5-swarm for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.