2
0
mirror of https://github.com/m-labs/artiq.git synced 2024-12-22 18:04:03 +08:00
artiq/nix/README.rst

29 lines
1.2 KiB
ReStructuredText
Raw Normal View History

Install ARTIQ via the Nix Package Manager
2018-08-17 12:19:16 +08:00
=========================================
2018-08-17 12:19:16 +08:00
These instructions provide an alternative route to install ARTIQ for people who do not wish to use conda.
2018-08-17 12:27:17 +08:00
This sets up an environment suitable for using ARTIQ, including the ARTIQ-Python compiler, device drivers, and the graphical user interfaces. This works correctly on Linux, and partially works (but not to a level that we would consider usable) with WSL introduced in Windows 10.
2018-08-17 12:19:16 +08:00
ARTIQ firmware and gateware development tools (e.g. rustc, Migen) and ARTIQ core device flashing tools (OpenOCD, proxy bitstreams) are currently not available on Nix. Pull requests welcome!
2018-08-17 12:19:16 +08:00
* Install the Nix package manager
2018-08-17 12:19:16 +08:00
* many Linux distros already have a package for the `Nix package manager <http://nixos.org/nix/>`_
2018-08-17 12:19:16 +08:00
* for example: ``$ apt-get install nix``
2018-08-17 12:19:16 +08:00
* if you would like to install via sh
2018-08-17 12:19:16 +08:00
* $ ``wget https://nixos.org/nix/install``
* $ ``sh install``
* $ ``source ~/.nix-profile/etc/profile.d/nix.sh``
* $ ``git clone github.com/m-labs/artiq``
* $ ``cd artiq/nix``
* $ ``nix-env -i -f default.nix``
2018-08-17 12:27:17 +08:00
The above command will setup your entire environment. Note that it will compile LLVM and Clang, which uses a lot of CPU time and disk space.