genesis README

README проекта с github.com/EMI-Group/genesis. Одним файлом markdown: README.md.

EvoX Genesis

One objective in. A software world unfolds.

Open-source AI agents for software development.
Describe the software you want. Genesis coordinates agents to build, validate, and evolve it.

Download Genesis · Website · Docs · Evidence · Paper

https://github.com/user-attachments/assets/d7f3d520-e39f-45cd-a525-77e5e8d00a75

Eighty seconds. One objective.
Watch the film on the website →

Use from a coding agent

The local MCP endpoint exposes task submission, progress, messaging and cancellation to compatible coding agents. Genesis runs the development work with its own configured models; the caller supplies context and checks the returned changes. Build this revision from source and follow the guide to configure a local credential and connect your MCP host.

See development unfold

New projects · Existing repositories · Remote development

Built with Genesis

Selected software worlds developed with Genesis.

Project What emerged Reported result
C Compiler A Rust-based C compiler built from scratch 220 / 220 c-testsuite
MESA 13 Fortran modules redeveloped in Rust 1,052 / 1,052 (0 failures) Rust test suite
tbench-wasm A software WebGL renderer in TypeScript 2,017 / 2,019 (99.90%) Khronos WebGL CTS

Latest evidence: EvoX Compiler · 2026-10-28

Explore all evidence →

The world persists. Agents do not.

Recursive Genesis agents delegate subtasks, commit changes on separate branches, and merge accepted work into main.

An objective becomes local work. Managers break down the goal, delegate tasks, and review the results. Executors implement and validate candidate changes in isolated Git worktrees.

Each task has a place. An accepted software version records what has been built; a repository path defines context, responsibility, and scope. CONTEXT.md files make these local contracts explicit.

Accepted results carry forward. The hierarchy unfolds as development proceeds. Agents finish their episodes; software versions and project history remain as the starting point for subsequent work.

Explore the architecture →

Start with an objective

Desktop app

Download Genesis → for macOS, Linux, or Windows. The website selects the installer for your platform; all published builds are available in GitHub Releases.

  1. Install and open Genesis.
  2. Configure a provider profile in Settings (API key or supported subscription OAuth), then choose its default model and, where supported, reasoning effort.
  3. Create a project or select an existing repository, then describe what you want to build.

For example:

Add rate limiting to this API. Preserve existing endpoint behavior, make the limits configurable, and add tests for requests above and below the limit.

Installation guide · Model configuration

Want to understand or operate Genesis? Open Assistant (/assistant) — Genesis Assistant understands the running system and can act on it: it reads Genesis source and inspects runtime state without approval, drives tasks and scheduler/configuration changes only after you approve the exact action, and answers in your language. See the Genesis Assistant guide for capabilities and safety boundaries.

Headless server

Run the dashboard and agent runtime on Linux (x86_64 or ARM64) or macOS (Apple Silicon):

curl -LsSf https://genesis.evox.group/dl/install.sh | sh
genesis start
genesis status
genesis update --check   # is a newer server release available?
genesis update           # install it and restart the server

Open http://127.0.0.1:9999 and configure your model provider in Settings. The server listens on localhost by default and has no built-in authentication; use an SSH tunnel for remote access.

Server installation and service management →

Provider profiles and model selection

A provider profile represents an account: its models share authentication, endpoint, concurrency, peak-hour schedules, and rate-limit backoff. Separate account IDs keep separate resource pools, even when they use the same provider and model.

In the task form, select Provider profile → Model → Reasoning effort; reasoning is a model-specific slider shown only when supported. An explicit choice locks that concrete selection for the task and its agents. Auto (by rules) leaves selection to your configured rules and defaults.

For example, in ~/.config/genesis/config.toml:

[llm]
default_provider_profile = "openai-main"

[[llm.providers]]
id = "openai-main"
provider = "openai"
auth_mode = "api_key"
api_key_env_var = "OPENAI_API_KEY"
concurrency = 3
default_model = "gpt-5"
reasoning_efforts = ["low", "medium", "high"]
default_reasoning_effort = "medium"
context_window = 200000

# Optional schedule shared by all models in this account:
peak_concurrency = 1
peak_hours = [{ start = "09:00", end = "18:00", days = ["weekdays"] }]
off_peak_days = ["sat", "sun"]
timezone = "Asia/Hong_Kong"

[[llm.providers.models]]
model = "gpt-5"

[[llm.providers.models]]
model = "gpt-5-mini"
default_reasoning_effort = "low"
context_window = 128000

Set OPENAI_API_KEY on the node running the task; do not put secrets in model rows. Nested model settings override generation, context-window, and reasoning defaults, not account authentication or capacity. The reasoning default is explicit—it is not inferred from the first effort in the list. OAuth uses account-level auth_mode = "oauth" and optional oauth_file; see subscription authentication.

The same concrete selection is available outside the task form through the MCP tool's task submission. An explicit choice locks that Provider profile → Model → Reasoning effort selection for the task and its agents, while Auto (by rules) keeps your configured defaults.

Legacy [[llm.models]] configuration remains a compatibility input; use provider profiles for new configuration. EvoGit.Config.Schema.resolve_model_spec/2 validates a programmatic selection before it is enqueued.

See Provider profiles and concrete model selection for defaults, migration, and scheduling details.

Remote development

Keep the desktop dashboard on your laptop and run agents on a server through an encrypted SSH tunnel. Tasks continue when the connection drops, and you can manage multiple remote targets from one dashboard.

Set up remote development →

Built for long-running development

Three layers: the Tauri desktop shell supervises the backend; the Phoenix LiveView dashboard exposes tasks, agents and diffs; the Elixir/OTP core schedules agents and manages Git worktrees.

Git records software versions; SQLite stores runtime and task data. Candidate changes run in isolated worktrees, with platform-specific execution controls described in the sandbox documentation.

Run from source

Use Elixir 1.20.4 and Erlang/OTP 29 to match the repository's CI environment, with Git installed.

git clone https://github.com/EMI-Group/genesis.git
cd genesis
mix deps.get
mix assets.setup
mix phx.server

Open http://localhost:4100.

Build the desktop app or use the Nix dev shell →

Benchmark your machine's I/O

Agents create worktrees, read and write files, and commit changes. Measure this workload on your filesystem:

mix bench.io
mix bench.io --dir /mnt/nvme --iterations 10 --files 500 --writes 50
mix bench.io --json > bench.json

The benchmark creates and removes its own throwaway repository without starting the Genesis runtime. Results cover worktree creation, reads and writes, Git operations, and worktree reclamation.

Research, community, and contributions

Genesis is developed by the EvoX Group at The Hong Kong Polytechnic University. For research and collaboration, get in touch. For bugs and feature requests, open an issue.

Contributions are welcome. See CONTRIBUTING.md for development guidelines and the contributor license agreement, which the CLA assistant handles on your first pull request.

Genesis grew out of EvoGit and follows the broader EvoX research lineage.

Released under the GNU Affero General Public License v3.0.

genesis (EMI-Group/genesis)

Ищем в базе…

Что это такое?Genesis — это система ИИ-агентов с открытым исходным кодом, которая создаёт, проверяет и развивает полноценные программные проекты по одной высокоуровневой цели. Агенты работают в изолированных рабочих деревьях Git, а принятые результаты переносятся дальше.
Это приложение, которое я устанавливаю, или библиотека, которую я подключаю?Это настольное приложение, которое вы запускаете локально, с необязательным серверным режимом без интерфейса. Вы описываете результат и ограничения, а Genesis распределяет работу между агентами-менеджерами, которые планируют, и агентами-исполнителями, которые вносят и проверяют изменения.
Как его запустить?Скачайте установщик для macOS, Linux или Windows со страницы GitHub Releases, установите и откройте его, затем создайте проект или выберите существующий репозиторий и опишите, что нужно построить.
Нужен ли мне собственный API-ключ?Да. Вы выбираете провайдера моделей и модель и предоставляете свои API-учетные данные. Для сборки из исходного кода также нужны Git, Elixir 1.20.4 и Erlang/OTP 29.
Безопасно ли открывать серверный режим наружу?По умолчанию нет. Сервер слушает localhost и не имеет встроенной аутентификации, поэтому удалённый доступ следует организовывать через туннель SSH.
Можно ли запустить это на сервере?Да. Режим без интерфейса запускает панель управления и среду выполнения агентов на Linux (x86-64 или ARM64) или на macOS с Apple Silicon. Панель можно оставить на ноутбуке, а агентов запускать на сервере через зашифрованный туннель SSH.
Где хранятся данные моего проекта?Git хранит версии программного обеспечения, а SQLite хранит данные выполнения и задач; и то, и другое находится на вашем компьютере. В README не сказано, какие данные отправляются выбранному вами провайдеру моделей.
Может ли он работать с уже существующим репозиторием?Да. Выберите существующий репозиторий вместо создания нового проекта, а затем опишите изменение. Принятые результаты становятся отправной точкой для последующей работы.
Как он не даёт многим агентам запутаться?Менеджеры разбивают цель и передают задачи, а исполнители вносят и проверяют предлагаемые изменения в изолированных рабочих деревьях Git. Файлы CONTEXT.md явно задают границы и зону ответственности каждой задачи.
Что уже создал Genesis?Среди заявленных результатов: C-компилятор на Rust, прошедший 220 из 220 тестов c-testsuite; модули MESA на Fortran, переписанные на Rust, прошедшие 1 052 из 1 052 тестов; и рендерер WebGL на TypeScript, прошедший 2 017 из 2 019 тестов Khronos WebGL CTS.
Какие есть похожие проекты?pullboard, zuse, adhdev, agent-orchestrator, open-swe, deer-flow, qwen-code, agentcraft
Автор
EMI-Group
Размер
52.7 MB
Звёзды
772
Возраст
1 г
Коммиты · 90 дней