AntOmniEvo README

The project's README from github.com/ant-research/AntOmniEvo. As one markdown file: README.md.

AntOmniEvo

An auto-evolution framework that optimizes anything — your 7×24 team of algorithm engineers.

License arXiv

English · 中文


AntOmniEvo is an auto-evolution framework with a strict division of labor: you define your system's tunable artifacts and what "good" means — the framework controls the loop, AI agents do the work — and it delivers optimized tunable artifacts.

Your system's tunable parts are abstracted as tunable artifacts — a real directory of files: an agent's SKILL.md + references + scripts, a workflow's pipeline.json + node scripts, a single-file algorithm + its description. Anything so representable, and repeatably evaluatable, AntOmniEvo can optimize — optimization becomes plain file editing. The system-under-optimization need not contain an LLM; the proposer must be agents.

🚀 What it is

AntOmniEvo is an auto-evolution framework for AI agent systems. It treats your system's tunable artifacts (skills, prompts, workflow configs, pipeline code) as the genome, and runs a concurrent evolution loop where a coding-agent Proposer reads failure trajectories and rewrites those artifacts — the way a human would edit code.

It works for any system that can be expressed as a directory of tunable files and has a repeatable, reasonably-cheap evaluation:

🧩 How it works

Division of labor: you define, framework controls, AI works.

You define — five things, once:

You provide Role
System how to run your system on one eval instance
Evaluator how to score its output (0–1) — its scoring criteria is the optimization objective
eval data the train/val instances that define "good"
TunableArtifactSchema maps your system's tunable artifacts onto a directory: the file tree + what each file is for
initial tunable artifacts the starting point

The framework controls — it runs the evolution loop, and all the control and engineering work inside it: scheduling, budgets, selection / elimination, persistence — deterministic machinery you don't write, keeping the strongest candidates in the population. Every candidate, run, analysis, and changelog is persisted to a CandidateStore — interruptible and resumable.

The AI works — the changing itself is done by a coding-agent Proposer: it reads failure trajectories, locates which file to edit, and lands a structured change as a new candidate's tunable artifacts — the way a human would edit code.

It delivers — the best candidate's tunable artifacts: a real directory of files you can diff, review, and deploy, with a change lineage attributing every edit to the failure evidence that motivated it.

📚 Documentation

Topic English 中文
Install & quick start docs/quickstart.md docs/quickstart.zh-CN.md
Features docs/features.md docs/features.zh-CN.md
Extensibility docs/extensibility.md docs/extensibility.zh-CN.md
When to use it docs/when-to-use.md docs/when-to-use.zh-CN.md
System design docs/system-design.md docs/system-design.zh-CN.md
Workspace artifacts & attribution docs/workspace-artifacts.md docs/workspace-artifacts.zh-CN.md
Checkpoint resume & crash recovery docs/checkpoint-resume.md docs/checkpoint-resume.zh-CN.md
Visualizer docs/visualizer.md docs/visualizer.zh-CN.md

📄 Paper

Coming soon. We will link the paper here once it is released.

⭐ Star History

Star History Chart

License

Licensed under the Apache License 2.0. Legal disclaimer: see LEGAL.md.

AntOmniEvo (ant-research/AntOmniEvo)

Searching Database…

Что это?AntOmniEvo — фреймворк автоэволюции: вы даёте ему настраиваемые артефакты своей системы (skills, промпты, конфиги workflow или код) плюс способ их оценивать, а он запускает параллельный цикл эволюции, в котором агент-кодер «Proposer» переписывает эти файлы, порождая более эффективные кандидаты.
Это фреймворк, встраиваемый в мою систему, или отдельное приложение?Это фреймворк, а не отдельное приложение и не обычная библиотека для вызова. Вы предоставляете System-раннер, Evaluator, eval-данные и TunableArtifactSchema, а фреймворк сам ведёт цикл оптимизации и агента-кодера Proposer.
Как запустить его на своей системе?Следуйте docs/quickstart.md с шагами установки и быстрого старта: подключаете System (как запускать вашу систему на одном eval-примере), Evaluator (как оценивать результат от 0 до 1), eval-данные и TunableArtifactSchema, описывающую дерево настраиваемых файлов, после чего запускаете цикл эволюции.
Что нужно подготовить, прежде чем запускать эволюцию?Нужны ваши собственные System, Evaluator и eval-данные, а также агент-кодер в роли Proposer, который будет править артефакты — сам фреймворк не поставляет ни LLM, ни оценщика.
Есть ли нюанс, который стоит знать до того, как на это полагаться?Оптимизируемая система не обязана содержать LLM, но Proposer, редактирующий ваши файлы, должен быть агентом, а сопроводительная статья проекта пока не опубликована.
Для кого это предназначено?Это для команд, у которых есть агентная система, workflow или алгоритм, уже выражаемые файлами и дёшево и воспроизводимо оцениваемые, — фактически им достаётся круглосуточная команда алгоритм-инженеров, автоматизирующая эту настройку.
Что именно считается «настраиваемым артефактом»?Всё, что выражается каталогом файлов с воспроизводимой оценкой: SKILL.md агента с файлами references и скриптами, pipeline.json workflow с кодом нод или один файл алгоритма с его описанием.
Как Proposer решает, что менять?Он читает траектории сбоев из прогонов оценки, находит, какой файл виноват в сбое, и вносит структурированную правку как нового кандидата — как поступил бы инженер-человек, правя код.
Можно остановить и продолжить долгий прогон эволюции?Да — каждый кандидат, прогон, анализ и список изменений сохраняются в CandidateStore, поэтому прогоны можно прерывать и возобновлять, включая восстановление после сбоя.
Что я в итоге получаю на выходе?Настраиваемые артефакты лучшего кандидата в виде настоящего каталога файлов, который можно диффить, ревьюить и разворачивать, с родословной изменений, возводящей каждую правку к данным о сбое, которые её вызвали.
Size
44.6 MB
Stars
1.2K
Updated
CommitOct 15
Age
1mo
Commits · 90 Days