explaingit

frenzymath/danus

Analysis updated 2026-05-18

92PythonAudience · researcherComplexity · 5/5LicenseSetup · hard

TLDR

Danus coordinates a Claude Code main agent and a swarm of worker agents to collaboratively prove mathematical statements, with a separate verifier that gates every claim into a shared fact graph.

Mindmap

mindmap
  root((danus))
    What it does
      Multi agent proof search
      Verified fact graph
      Paper generation
    Tech stack
      Python
      Claude Code
      Codex
      MCP
    Use cases
      Mathematical research
      Proof verification
      Report writing
    Audience
      Researchers
      Mathematicians

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

Break a hard mathematical problem into smaller claims and have a swarm of agents attempt to prove each one.

USE CASE 2

Keep a verified record of which mathematical facts have actually passed a checking step, avoiding unverified claims creeping into the result.

USE CASE 3

Generate a human-readable progress report or a publishable LaTeX paper from a completed proof search.

USE CASE 4

Study the fact-graph and role-separation architecture as a pattern for other multi-agent verification systems.

What is it built with?

PythonClaude CodeCodexMCP

How does it compare?

frenzymath/danusagricidaniel/claude-shortscalesthio/generative-media-skills
Stars929393
LanguagePythonPythonPython
Setup difficultyhardmoderateeasy
Complexity5/53/52/5
Audienceresearcherdeveloperdeveloper

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

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires your own API keys for Claude Code and a codex backend, plus running a local verification service.

Apache 2.0 license, free to use, modify, and distribute including for commercial purposes, with patent protection included.

In plain English

Danus is a Python system that coordinates a team of AI agents to work through mathematical proofs together and keep track of what has actually been verified as true. A main agent, built on Claude Code, plans the overall strategy and directs a group of worker agents, each built on the codex tool, that attempt to prove individual pieces of a larger problem, such as a single lemma or example. The key design choice is a strict separation of roles. Workers submit a claim along with a supporting proof, and a separate verifier agent checks it and either accepts or rejects it with feedback for revision. Only the verifier can decide whether something counts as proven, and it does not keep memory between checks, judging each submission fresh. Once a claim passes, it is added to a shared fact graph, a structure that records every verified result and which earlier facts it depended on. The main agent itself has no ability to add unverified claims to this fact graph, so the separation between planning and truth checking is built into the system rather than relying on instructions alone. Because each worker only needs to load the specific facts relevant to its current claim, the amount of context any single agent has to hold stays manageable even as the overall proof grows very large. The README shows an example run that produced over 3,100 verified facts connected by more than 8,600 dependencies. Once a problem is solved, Danus can turn the accumulated fact graph into a written report or a formatted LaTeX paper. Setup involves running a bootstrap script to install dependencies, copying example configuration files and filling in your own API keys, starting a verification service, and then connecting Claude Code to the project directory. The system relies on the user's own API keys throughout and is licensed under Apache 2.0. Danus builds on an earlier project by the same team called Rethlas.

Copy-paste prompts

Prompt 1
Explain how Danus separates the roles of the main agent, workers, and verifier during a proof search.
Prompt 2
Walk me through the bootstrap and configuration steps needed to run Danus with my own API keys.
Prompt 3
How does Danus's fact graph prevent unverified claims from being treated as proven?
Prompt 4
What does the write-paper feature need in order to turn a completed proof into a LaTeX paper?

Frequently asked questions

What is danus?

Danus coordinates a Claude Code main agent and a swarm of worker agents to collaboratively prove mathematical statements, with a separate verifier that gates every claim into a shared fact graph.

What language is danus written in?

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

What license does danus use?

Apache 2.0 license, free to use, modify, and distribute including for commercial purposes, with patent protection included.

How hard is danus to set up?

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

Who is danus for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.