# below/HelloSilicon

An introduction to ARM64 assembly on Apple Silicon Macs

Repository: https://github.com/below/HelloSilicon
Canonical: https://ross.abutalabs.com/products/hellosilicon
Language: Assembly
License: MIT
License Family: permissive
Topics: arm64, darwin, mach-o, macos, ios, clang-assembler, apple, apple-silicon, assembler, arm, assembly, aarch64, m1
Last push: 2026-05-15T21:16:21+00:00

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

## Adoption (not part of the score)
Stars 4986, forks 328 (observed 2026-08-28T04:09:04.232235+00:00)

## What it is
A repository of ARM64 assembly language sample code adapted for Apple Silicon Macs, accompanying the book 'Programming with 64-Bit ARM Assembly Language'. It explains Darwin/macOS-specific differences such as system calls and memory access compared to the book's Linux examples.

## Use cases
- learn ARM64 assembly on Apple Silicon
- adapt Linux ARM assembly examples to macOS
- understand Darwin system calls in assembly
- study M1 assembly programming
- follow along with a 64-bit ARM assembly book on a Mac

## When to choose
- you have an Apple Silicon Mac and want to learn assembly
- you're reading the Apress ARM64 assembly book and need macOS-adjusted code
- you want to understand Mach-O/Darwin assembly conventions

## When to avoid
- you need assembly tutorials for Linux or Windows
- you want a general-purpose assembler tool rather than educational sample code
- you don't have access to Apple hardware or Xcode

## Facets
- artifact type: learning-resource
- maturity: active
- function: programming-language, developer-tools, compiler
- domain: education, programming-languages, apple-ecosystem, tutorials
- platform: -
- tags: arm64-assembly, apple-silicon, aarch64, assembler, mach-o, darwin, m1, sample-code, book-companion, macos, ios, arm64

## Member repositories
- below/HelloSilicon (main) score 60

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:04.232235+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-29T18:17:40.941382+00:00, confidence not recorded.
  - readme: https://github.com/below/HelloSilicon (fetched 2026-08-28T04:09:04.232235+00:00, sha e3c0abf81b38)
- Data as of 2026-08-30T08:39:29.467469+00:00.