Deepgraph README

The project's README from github.com/billion-token-one-task/Deepgraph. As one markdown file: README.md.

DeepGraph: an autonomous research agent that improves by being judged by reality

The autonomous research agent of JouleBeat, an open-source RSI lab.
It reads the literature, finds open questions, runs the experiments,
and lets reality decide what is true.

Website · Results · Showcase · Architecture · 中文

MIT Python 3.12+ Harness × Benchmark


Why DeepGraph

JouleBeat builds self-improving AI by letting harnesses and benchmarks evolve together.

How an agent works (its harness: tools, memory, workflow, verification) now moves capability by as much as a model generation, and open source has made harness variants cheap to generate. What is still scarce is the benchmark that tells real progress from a lucky score. So we put both in the loop: harnesses compete under benchmarks, and benchmarks compete on how well they predict results that arrive later.

That loop needs a steady stream of real tasks whose answers can be checked. Computational research is exactly that: a conclusion is confirmed or refuted by rerunnable code, held-out data or an independent recomputation, in minutes to days. DeepGraph is where those tasks come from.

How it works

Step What happens
1 Read Harvests arXiv at scale and extracts claims, methods and results
2 Map Merges them into an evidence graph of entities, relations and contradictions
3 Ask Ten structural detectors find open questions in pure SQL, with no LLM in the path
4 Test Turns a question into a pre-registered, budgeted experiment on CPU or GPU
5 Judge An evidence ladder issues a verdict only when the comparison is fair, and the result updates what gets searched next

Every verdict is auditable, and the system audits itself: in August 2026 it found and retracted 11 of its own conclusions that rested on empty model outputs. A search loop is only as good as the filter that decides what is true. Details in Results.

At a glance

Live production data, August 2026.

Papers 24,407 harvested, 7,005 through the full evidence pipeline
Evidence graph 248,441 entities, 735,913 relations, 238 contradiction clusters
Discovery 25,652 mapped research opportunities
Experiments 150 audited verdicts across six research agendas
Compute 921M LLM tokens invested

The JouleBeat stack

Layer What it is Status
DeepGraph Research agent: real tasks in, checkable conclusions out In service, with paying research groups
Harness × Benchmark libraries Versioned harnesses, and benchmarks scored on how well they predicted later outcomes Harness versioning running; benchmark validation in build
Evolution Kernel The engine: propose, evaluate, accept or roll back Open source, pip install evolution-kernel

Quick start

Python 3.12+ and an LLM API key are the minimum; PostgreSQL enables the full control plane.

python3.12 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env    # set at least DEEPGRAPH_LLM_API_KEY
export $(grep -v '^#' .env | xargs)
python3.12 main.py      # open http://localhost:8080

Full deployment (PostgreSQL, systemd, remote GPU backends): docs/DEPLOY.md.

Learn more

Contributing

Researchers: bring a computational question at deepgraph.joulebeat.com. Developers: issues and pull requests are welcome; contributions are covered by the CLA.

License

MIT

Deepgraph (billion-token-one-task/Deepgraph)

Searching Database…

Что это такое?DeepGraph — автономный исследовательский агент JouleBeat, open-source лаборатории самоулучшения AI (RSI). Он читает научную литературу, находит открытые вопросы, проводит настоящие эксперименты и позволяет результатам решать, что истинно.
Это отдельное приложение или скорее конвейер?Это сквозной исследовательский конвейер: он собирает статьи с arXiv в граф знаний с доказательствами, находит открытые вопросы чистым SQL (без LLM) и превращает их в эксперименты с бюджетом, которые оцениваются по «лестнице доказательств».
Как его запустить?Quick start требует Python 3.12+ и API-ключ LLM; для полной управляющей плоскости с PostgreSQL, systemd и удалёнными GPU-бэкендами следуйте руководству по развёртыванию в docs/DEPLOY.md.
Мне нужно сначала поднять базу данных, или она опциональна?PostgreSQL опционален для минимального quick start, но обязателен, чтобы открыть полную управляющую плоскость, развёртывание через systemd и удалённые GPU-бэкенды.
Каждому ли его выводу можно доверять?Система сама себя аудитирует, а не гарантирует корректность каждого запуска: в августе 2026 года она поймала и отозвала 11 собственных выводов, опиравшихся на пустые ответы модели.
Для кого это на самом деле?Оно создано для исследователей, которым нужны проверяемые вычислительные выводы, и заодно служит собственным R&D-циклом JouleBeat для эволюции агентских каркасов и бенчмарков.
Что такое Evolution Kernel?Это open-source движок, стоящий за стеком JouleBeat: он предлагает, оценивает, принимает или откатывает изменения каркасов и бенчмарков. Устанавливается отдельно через pip install evolution-kernel.
Как он находит открытые исследовательские вопросы без LLM в цикле?Десять структурных детекторов запрашивают граф доказательств чистым SQL, чтобы выявить открытые вопросы, не допуская LLM на этом конкретном шаге — ради детерминированности и проверяемости.
Что DeepGraph уже успел произвести?По его производственным данным на август 2026 года он собрал 24,407 статей (7,005 полностью обработано), построил граф из 248,441 сущностей и 735,913 связей и выдал 150 проаудированных экспериментальных вердиктов в рамках шести исследовательских программ.
Почему JouleBeat создал это вместо простого тестирования моделей напрямую?JouleBeat нужен постоянный поток настоящих проверяемых задач, по которым можно судить о новых агентских каркасах и бенчмарках; вычислительные исследования дают именно это, потому что выводы можно подтвердить или опровергнуть, перезапустив код или данные.
Size
85.1 MB
Stars
1K
Age
7mo
Commits · 90 Days