mlboydaisuke/gemma-3-4b-it-CoreAI-official

Gemma 3 4B IT — official Apple Core AI export

Pre-converted .aimodel bundles from Apple's official coreai-models export recipe — unmodified, with the exact environment, hashes, and measured performance published.

uv run coreai.llm.export gemma3-4b-it          # bfloat16 compute per registry preset

Why pre-converted bundles?

1. The conversion needs a big-RAM Mac (the 20B export was done on 128 GB); running only needs enough RAM to mmap the artifact.
2. An .aimodel is a build artifact, not a pure function of the recipe — the same export command produced a 2.2× slower artifact across the macOS 26 → 27β boundary (forensics). Hosted artifacts + hashes are the reproducible ground truth; every bundle here is exactly the one measured in apple-silicon-llm-bench.

Bundles & integrity

Bundle	Contents	SHA-256 (main.mlirb)
macos/	macOS dynamic, int4 (bf16 compute)	68b103aa2994ed50b9bb14f32bd9f746afc7eebae4b65d28c913a72dbd5fce91

Measured (Apple's official llm-benchmark, greedy)

Bundle	Protocol	Decode tok/s	Prefill	Load (warm)	Peak RSS
macos	M4 Max, 512p/1024g	141.5	1,669	0.32 s	4.5 GB

Export environment

• macOS 27.0 beta (build 26A5353q) · Xcode 27.0 (27A5194q)
• coreai-core 1.0.0b1 · coreai-torch 0.4.0 · coreai-opt 0.2.0 · torch 2.9.0
• apple/coreai-models @ b1cb71b (export code identical to upstream 0c1055f)

Run it

# CLI (from a coreai-models checkout)
swift run -c release llm-runner --model <downloaded-bundle-dir> --prompt "Hello"
swift run -c release llm-benchmark --model <downloaded-bundle-dir>

Or chat with it in CoreAIChatMac (point "Choose Models Folder…" at the download directory).

iOS static bundles must be AOT-compiled before device use: xcrun coreai-build compile <ir>.aimodel --platform iOS --preferred-compute neural-engine --architecture h18p (h18p = iPhone 17 Pro), then set metadata.json assets.main to the .aimodelc.

Use of this model is subject to the Gemma Terms of Use. This repository redistributes a converted derivative of google/gemma-3-4b-it under those terms; by downloading you agree to them.

---

Maintained alongside coreai-model-zoo (community models) and coreai-samples (apps).