reims-vgpu is an experimental virtual GPU for macOS guests that uses QEMU to decode the guest's GPU command stream and execute it through Metal or Vulkan, leveraging the built-in AppleParavirtGPU driver without requiring custom kexts.

Stars

115

7-day growth

No data

Forks

5

Open issues

3

License

LGPL-3.0

Last updated

2026-07-27

Why it is worth attention

It enables accelerated graphics in macOS VMs without modifying the guest OS, by implementing the device side of Apple's paravirtual GPU interface and translating commands via Metal or Vulkan, which is a novel approach in the open-source virtualization space.

Who it is for

  • Developers working on GPU virtualization for macOS
  • QEMU contributors interested in GPU device models
  • Researchers exploring Metal-to-Vulkan translation
  • Hobbyists experimenting with macOS VMs on non-Apple hardware

Use cases

  • Running macOS 13 Ventura guests with hardware-accelerated graphics on Linux or Apple Silicon hosts
  • Testing and debugging Metal/Vulkan translation via metal2vulkan
  • Developing and validating custom GPU command stream decoders
  • Evaluating snapshot-revert workflows for reproducible VM testing

Strengths

  • No custom guest driver or kext installation required—uses existing AppleParavirtGPU.kext
  • Supports three distinct host/guest/backend pathways (x86+Linux+Vulkan, arm64+macOS+Metal, arm64+macOS+Vulkan)
  • Provides snapshot-revert boot scripts that protect golden images from corruption
  • Open source under LGPL-3.0-or-later with a modular Rust codebase and vendored QEMU shims

Considerations

  • Alpha stage—ABI, behavior, and supported pathways may change without notice
  • Requires significant host configuration (KVM, Vulkan/Metal stacks, custom QEMU build)
  • Not production-ready; focused on experimentation and bring-up

README quick start

Getting started

Description

reims-vgpu is an experimental virtual GPU for macOS guests

Related repositories

Similar projects matched by category, topics, and programming language.

Blaizzy
Featured
Blaizzy GitHub avatar

nativ

Nativ is a native macOS app that lets you run AI models locally on Apple silicon, offering chat, model management, performance analytics, and an OpenAI/Anthropic-compatible API server.

AI & Machine LearningAI Agents
916
xai-org
Featured
xai-org GitHub avatar

grok-build

Grok Build is SpaceXAI's terminal-based AI coding agent that runs as a full-screen TUI, understands codebases, edits files, executes commands, searches the web, and manages tasks interactively or headlessly.

AI & Machine LearningAI Agents
20,399
mereyabdenbekuly-ctrl
Featured
mereyabdenbekuly-ctrl GitHub avatar

clodex-ide

Clodex is an open-source, local-first agentic IDE that combines persistent AI tasks, code, terminal, browser, Git, models, memory, and governed execution in one Electron workspace, currently in technical preview.

AI & Machine LearningAI Agents
833