# jauhien/iron-kaleidoscope

LLVM tutorial in Rust language

Repository: https://github.com/jauhien/iron-kaleidoscope
Canonical: https://ross.abutalabs.com/products/iron-kaleidoscope
Language: Rust
License: NOASSERTION
License Family: other
Last push: 2024-04-03T22:15:52+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 4361, "days_push": 882, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases, no_license
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1244, forks 90 (observed 2026-08-28T04:04:06.840599+00:00)

## What it is
A Rust-language port of the official LLVM Kaleidoscope tutorial, walking through building a lexer, parser, AST, LLVM IR code generation, optimizer, and JIT compiler for a small toy language. The README states the code is completely outdated and nothing currently works.

## Use cases
- learn how to build a compiler with LLVM in Rust
- follow the LLVM Kaleidoscope tutorial in Rust
- understand LLVM IR code generation from an AST
- learn how to implement a JIT compiler with MCJIT
- study lexer and recursive descent parser implementation
- learn compiler basics by building a toy language

## When to choose
- you want a Rust-flavored walkthrough of the classic LLVM Kaleidoscope tutorial
- you learn best from chapter-by-chapter compiler construction examples
- you want to see how LLVM bindings are used from Rust

## When to avoid
- you need working, up-to-date code - the README says nothing works and the Rust code is outdated
- you want a maintained library or production compiler toolchain
- you need the full tutorial beyond chapter 7 (mutable variables)

## Facets
- artifact type: learning-resource
- maturity: abandoned
- function: compiler, interpreter, parser, documentation
- domain: compilers, programming-languages, tutorials, education
- platform: rust, cpp, cross-platform
- tags: llvm, kaleidoscope, jit, code-generation, tutorial, rust

## Member repositories
- jauhien/iron-kaleidoscope (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:06.840599+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T05:08:15.291495+00:00, confidence not recorded.
  - readme: https://github.com/jauhien/iron-kaleidoscope (fetched 2026-08-28T04:04:06.840599+00:00, sha 65ec786663d2)
- Data as of 2026-08-30T08:39:29.467469+00:00.