https://github.com/user-attachments/assets/d7f3d520-e39f-45cd-a525-77e5e8d00a75
See development unfold
- Set an objective. Start a new project or bring an existing repository. Describe the outcome and constraints; Genesis decomposes the work as needed.
- Follow the work. Watch the recursive agent tree, inspect tasks and model usage, and review diffs in the desktop dashboard.
- Keep developing. Continue from accepted results, refine the objective, or move execution to a server while keeping your local dashboard.
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.
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.
- Install and open Genesis.
- Choose a model provider and model, and configure your API credentials.
- 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
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
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 →
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
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 →
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.
