accelerate-llvm: Accelerate backend component generating LLVM IR

[ accelerate, bsd3, compilers-interpreters, concurrency, data, library, parallelism ] [ Propose Tags ] [ Report a vulnerability ]

This library implements direct LLVM IR generation for the Accelerate language. For further information, refer to the main accelerate package. As a user of Accelerate, you do not need to use this package; use accelerate-llvm-native or accelerate-llvm-ptx instead.

Dependencies

Haskell dependencies are available from Hackage. The following external dependencies are also required:

clang (not used to compile C code, but to compile generated LLVM IR via a mostly LLVM-version-independent interface)
libFFI (if using accelerate-llvm-native)
CUDA (if using accelerate-llvm-ptx)

For installation instructions, see the README.

This package includes (and exposes) a forked copy of llvm-pretty due to some breaking changes needed to make accelerate-llvm work. Upstreaming these changes is planned. This code (under Data.Array.Accelerate.LLVM.Internal.LLVMPretty) is not public API and may disappear or change at any time.

[Skip to Readme]

Modules

[Index] [Quick Jump]

Data
- Array
  - Accelerate
    - LLVM
      - Data.Array.Accelerate.LLVM.AST
      - Array
        Data.Array.Accelerate.LLVM.Array.Data
      - Data.Array.Accelerate.LLVM.CodeGen
        Data.Array.Accelerate.LLVM.CodeGen.Arithmetic
        Data.Array.Accelerate.LLVM.CodeGen.Array
        Data.Array.Accelerate.LLVM.CodeGen.Base
        Data.Array.Accelerate.LLVM.CodeGen.Constant
        Data.Array.Accelerate.LLVM.CodeGen.Environment
        Data.Array.Accelerate.LLVM.CodeGen.Exp
        Data.Array.Accelerate.LLVM.CodeGen.IR
        Data.Array.Accelerate.LLVM.CodeGen.Intrinsic
        Data.Array.Accelerate.LLVM.CodeGen.Loop
        Data.Array.Accelerate.LLVM.CodeGen.Module
        Data.Array.Accelerate.LLVM.CodeGen.Monad
        Data.Array.Accelerate.LLVM.CodeGen.Permute
        Data.Array.Accelerate.LLVM.CodeGen.Profile
        Data.Array.Accelerate.LLVM.CodeGen.Ptr
        Data.Array.Accelerate.LLVM.CodeGen.Skeleton
        Data.Array.Accelerate.LLVM.CodeGen.Stencil
        Data.Array.Accelerate.LLVM.CodeGen.Sugar
        Data.Array.Accelerate.LLVM.CodeGen.Type
      - Data.Array.Accelerate.LLVM.Compile
        Data.Array.Accelerate.LLVM.Compile.Cache
      - Data.Array.Accelerate.LLVM.Embed
      - Data.Array.Accelerate.LLVM.Execute
        Data.Array.Accelerate.LLVM.Execute.Async
        Data.Array.Accelerate.LLVM.Execute.Environment
        Data.Array.Accelerate.LLVM.Execute.Marshal
      - Data.Array.Accelerate.LLVM.Extra
      - Data.Array.Accelerate.LLVM.Foreign
      - Internal
        Data.Array.Accelerate.LLVM.Internal.LLVMPretty
        Data.Array.Accelerate.LLVM.Internal.LLVMPretty.AST
        Data.Array.Accelerate.LLVM.Internal.LLVMPretty.DebugUtils
        Data.Array.Accelerate.LLVM.Internal.LLVMPretty.Labels
        Data.Array.Accelerate.LLVM.Internal.LLVMPretty.Labels.TH
        Data.Array.Accelerate.LLVM.Internal.LLVMPretty.Lens
        Data.Array.Accelerate.LLVM.Internal.LLVMPretty.PP
        Data.Array.Accelerate.LLVM.Internal.LLVMPretty.Parser
        Data.Array.Accelerate.LLVM.Internal.LLVMPretty.Triple
        Data.Array.Accelerate.LLVM.Internal.LLVMPretty.Triple.AST
        Data.Array.Accelerate.LLVM.Internal.LLVMPretty.Triple.Parse
        Data.Array.Accelerate.LLVM.Internal.LLVMPretty.Triple.Print
      - Data.Array.Accelerate.LLVM.Link
        Data.Array.Accelerate.LLVM.Link.Cache
      - Data.Array.Accelerate.LLVM.State
      - Data.Array.Accelerate.LLVM.Target
        Data.Array.Accelerate.LLVM.Target.ClangInfo
    - TH
      - Data.Array.Accelerate.TH.Compat
- ByteString
  - Short
    - Data.ByteString.Short.Char8
    - Data.ByteString.Short.Extra
LLVM
- AST
  - Type
    - LLVM.AST.Type.Constant
    - LLVM.AST.Type.Downcast
    - LLVM.AST.Type.Function
    - LLVM.AST.Type.GetElementPtr
    - LLVM.AST.Type.Global
    - LLVM.AST.Type.InlineAssembly
    - LLVM.AST.Type.Instruction
      - LLVM.AST.Type.Instruction.Atomic
      - LLVM.AST.Type.Instruction.Compare
      - LLVM.AST.Type.Instruction.RMW
      - LLVM.AST.Type.Instruction.Volatile
    - LLVM.AST.Type.Metadata
    - LLVM.AST.Type.Name
    - LLVM.AST.Type.Operand
    - LLVM.AST.Type.Representation
    - LLVM.AST.Type.Terminator

Downloads

accelerate-llvm-1.4.0.0.tar.gz [browse] (Cabal source package)
Package description (as included in the package)

Maintainer's Corner

Package maintainers

TrevorMcDonell, tomsmeding

For package maintainers and hackage trustees

edit package information

Candidates

1.3.0.0

Versions [RSS]	1.0.0.0, 1.1.0.0, 1.2.0.0, 1.2.0.1, 1.3.0.0, 1.4.0.0
Change log	CHANGELOG.md
Dependencies	accelerate (>=1.4 && <1.5), accelerate-llvm, base (>=4.11 && <5), bytestring (>=0.10.4), constraints (>=0.9), containers (>=0.5 && <0.9), data-default-class (>=0.0.1), deepseq (>=1.3), directory (>=1.2.3), dlist (>=0.6), exceptions (>=0.6), filepath (>=1.0), formatting (>=7.0), hashable (>=1.1), microlens (>=0.4), microlens-th (>=0.4), monadLib (>=3.6.1), mtl (>=2.0), parsec (>=3), pretty (>=1.0.1), primitive (>=0.6.4), process, syb (>=0.7), template-haskell (>=2.7), text (>=1.2), th-abstraction (>=0.3.1 && <0.8), unordered-containers (>=0.2), vector (>=0.10) [details]
Tested with	ghc >=9.4
License	BSD-3-Clause
Author	Trevor L. McDonell
Maintainer	Trevor L. McDonell <trevor.mcdonell@gmail.com>
Uploaded	by tomsmeding at 2026-04-02T16:43:36Z
Category	Accelerate, Compilers/Interpreters, Concurrency, Data, Parallelism
Bug tracker	https://github.com/AccelerateHS/accelerate/issues
Source repo	head: git clone https://github.com/AccelerateHS/accelerate-llvm.git this: git clone https://github.com/AccelerateHS/accelerate-llvm.git(tag v1.4.0.0)
Reverse Dependencies	6 direct, 14 indirect [details]
Downloads	6033 total (20 in the last 30 days)
Rating	(no votes yet) [estimated by Bayesian average]
Your Rating	λ λ λ
Status	Docs available [build log] Last success reported on 2026-04-02 [all 1 reports]

Readme for accelerate-llvm-1.4.0.0

[back to package description]

LLVM backends for the Accelerate array language

This package compiles Accelerate code to LLVM IR, and executes that code on multicore CPUs as well as NVIDIA GPUs. This avoids the need to go through nvcc or write C++ code. For details on Accelerate, refer to the main repository.

We love all kinds of contributions, so feel free to open issues for missing features as well as report (or fix!) bugs on the issue tracker.

Dependencies

Dependencies

Haskell dependencies are available from Hackage, but there are some external library dependencies that you will need to install as well:

if using accelerate-llvm-native for multicore CPU: libFFI
if using accelerate-llvm-ptx for GPU: CUDA; Note that not all versions of CUDA support all NVIDIA GPUs
clang (if using accelerate-llvm-ptx: version 16 or higher, built with support for the nvptx backend). accelerate-llvm uses the command-line tool as a way to be compatible with many different LLVM versions, not to compile C code. (Accelerate passes LLVM IR to clang.)

Below are some OS-specific instructions. If anything here is wrong or out of date, please file an issue.

macOS

To get libFFI, run brew install libffi. clang is already provided with macOS (you may need to xcode-select --install), and CUDA is not supported on macOS.

Debian/Ubuntu

For clang:

On Ubuntu 24.04 (noble) / Debian trixie or higher: sudo apt install clang.
Otherwise, if you need only the CPU backend (accelerate-llvm-native): sudo apt install clang will give you an old version of clang, but the CPU backend is likely to work fine.
If you are on an older distro and need the GPU backend (accelerate-llvm-ptx): clang version 16 or higher is required. Add the apt source from apt.llvm.org. The neatest way to do this is to create a file /etc/apt/sources.list.d/llvm.list (the precise file name does not matter) and put in it, for Ubuntu (change "jammy" as appropriate):
```
deb http://apt.llvm.org/jammy/ llvm-toolchain-jammy main
deb-src http://apt.llvm.org/jammy/ llvm-toolchain-jammy main
```
or for Debian (change "bookworm" as appropriate):
```
deb http://apt.llvm.org/bookworm/ llvm-toolchain-bookworm main
deb-src http://apt.llvm.org/bookworm/ llvm-toolchain-bookworm main
```
and sudo apt update; sudo apt install clang. This gets you the latest version of clang; different sources are also available for specific versions (see apt.llvm.org).

To use the CPU backend (accelerate-llvm-native), install libFFI using sudo apt install libffi-dev.

To use the GPU backend (accelerate-llvm-ptx), install CUDA from here ("deb (network)" is smoother than the "deb (local)" option).

Arch Linux

Run sudo pacman -S clang. To use the CPU backend (accelerate-llvm-native), additionally run sudo pacman -S libffi. To use the GPU backend (accelerate-llvm-ptx), additionally run sudo pacman -S cuda.

Windows

We recommend WSL2 (not WSL1, WSL2!) and following the Ubuntu instructions above. The remainder of this text attemps to give you a working system on Windows native.

Install clang; you have two options:

Using WinGet: winget install LLVM.LLVM
By downloading the installer directly (WinGet just runs the same installer) from here (choose "LLVM-<version>-win64.exe" from the latest release; you may need to click "Show all 57 assets"). This will also give you libFFI.

Optionally, add clang (and more) to your system path. Click to see how.

Accelerate should be able to find clang automatically even if you do not do this. However, for easy access to clang and all other LLVM executables, add C:\Program Files\LLVM\bin to the system path as follows:

Search for "environment variables" in the start menu
Click "Edit the system environment variables"
Click on "Environment Variables..."
Double-click on the user variable called "Path"
And add a new entry containing C:\Program Files\LLVM\bin.

Note that if you add an entry here manually, it is a good idea to clean it up again if you uninstall LLVM/clang. (Leaving it there is not very harmful, however.)

You may find that the LLVM/clang installer has already added the Path entry automatically (it did not for us); if so, no need to add a second entry.

——

You may additionally need the VS Build Tools, if you have not yet installed and set up Visual Studio otherwise. You need this if clang complains that it is unable to find a Visual Studio installation; try running Clang from a developer command prompt.

If you already have the Visual Studio Installer on your system, open it and check if you already have Visual Studio (Community) installed. Note that this is completely unrelated to VS Code.
- If you already have VS (Community): inside the Visual Studio Installer, click on "Modify" in the VS (Community) box. This should get you a screen with "workloads" you can select.
- If you do not yet have VS (Community), install the VS Build Tools: go to https://visualstudio.microsoft.com/downloads, scroll down to "All Downloads", open "Tools for Visual Studio", and select "Build Tools for Visual Studio". If you run the installer, you should get a screen with "workloads" you can select.
Under the Workloads tab, choose the "Desktop development with C++" workload. If you want to save a bit of disk space (not much), keep only the following two options selected:
- "MSVC v143 - VE 2022 C++ x64/x86 build tools (Latest)"
- "Windows 11 SDK (…)" (choose the latest option). The attentive reader may note that the wizard also offers Clang; we recommend a separate Clang install for Accelerate because the one from VS somehow doesn’t seem to work properly with Accelerate. If you find out why, please let us know.
Install that. This takes a while.

It turns out that having both Visual Studio and the Build Tools installed results in Clang getting confused between the two (it appears that Visual Studio is 64-bit (x64) and the Build Tools are 32-bit (x86)). If Clang complains about the bit-ness of your system libraries, double-check that you haven’t installed both simultaneously.

The GPU backend (accelerate-llvm-ptx) probably doesn't work on Windows; in any case, it is untested.