git404hub

what is lean64 fr?

aouxwoux/lean64 — explained in plain English

Analysis updated 2026-05-18

3LeanAudience · developerComplexity · 3/5Setup · moderate

tl;dr

A Doom-inspired first-person shooter game with its core logic written almost entirely in the Lean proof-assistant language.

vibe map

mindmap
  root((Lean 64))
    What it does
      Doom-style shooter
      Written in Lean
      Two-map campaign
    Tech stack
      Lean
      Win32
      OpenGL
    Gameplay
      Shotgun and chaingun
      Enemy AI and boss
      Secrets and keycards
    Architecture
      Game logic in Lean
      Native graphics shim
    Audience
      Lean developers
      Retro FPS fans

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 make with this?

VIBE 1

Play a small original two-level first-person shooter with three difficulty settings.

VIBE 2

See a real example of Lean, normally used for math proofs, used to build game logic.

VIBE 3

Study how game state, AI, and rendering are separated from a native graphics shim in Lean.

what's the stack?

LeanWin32OpenGL

how it stacks up fr

aouxwoux/lean64trailofbits/scroll-fvtripp-smith/lean-lfse
Stars30
LanguageLeanLeanLean
Last pushed2026-05-14
MaintenanceMaintained
Setup difficultymoderatehardmoderate
Complexity3/55/54/5
Audiencedeveloperresearcherdeveloper

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

how do i run it?

Difficulty · moderate time til it works · 30min

Requires installing elan to manage the Lean toolchain, then building with lake.

No license information was found in the description provided.

in plain english

Lean 64 is a small first-person shooter game inspired by the classic game Doom, but with a twist: almost the entire game is written in Lean, a programming language normally used for mathematical proofs and formal verification rather than games. The author notes with some surprise that Lean turns out to be capable enough to build a real playable game in. The game runs in its own window and includes a title screen with three difficulty settings, a small two level campaign, and a fair amount of content for such an unusual experiment. Players can walk and strafe around 3D levels, aim with the mouse, sprint, fire weapons, open doors and switches, and check their progress on an in game map. There are two collectible weapons, a double barrel shotgun and a multi barrel chaingun, each with its own firing animation, sound, and recoil behavior. Combat includes multiple enemy types with basic artificial intelligence that can notice the player, chase them, attack up close or from range, and eventually die with visible effects like blood, sparks, and debris. The two levels end in an encounter with a stronger boss enemy. Along the way players can find hidden secret areas, pick up health and ammunition, and unlock progress using a collectible keycard, all tracked with an end of level results screen showing accuracy, kills, and score. Technically, the project separates the actual game logic, meaning things like physics, enemy behavior, camera movement, and menus, from the low level graphics and sound plumbing. The game logic itself is written entirely in Lean, while a small supporting piece of code handles opening a graphics window, talking to the computer's graphics hardware, and playing sound effects, since Lean on its own cannot do those platform specific tasks. All the visuals and sounds in the game are original and generated by the project itself rather than reused from Doom or any commercial game, since the author avoided using any copyrighted game data. To run it, you need to install a tool called elan, which manages Lean installations, and then use two build commands to compile and launch the game.

prompts (copy fr)

prompt 1
Help me install elan and build lean64 with lake build and lake exe lean64.
prompt 2
Explain how Lean 64 separates game logic in Lean from the native Win32/OpenGL shim.
prompt 3
Walk me through the controls and difficulty options in Lean 64.
prompt 4
What monster and weapon systems does Lean 64 implement, based on its README?

Frequently asked questions

what is lean64 fr?

A Doom-inspired first-person shooter game with its core logic written almost entirely in the Lean proof-assistant language.

What language is lean64 written in?

Mainly Lean. The stack also includes Lean, Win32, OpenGL.

What license does lean64 use?

No license information was found in the description provided.

How hard is lean64 to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is lean64 for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.