It is very easy to get started with LIQ𝑈𝑖⏐〉 on your platform of choice.

You just need a shell, a text editor and 10 minutes of your time. Ready? Set? Let's go!

1

Install Visual Studio

The best way to install Visual Studio is to download the official MSI installer. This will install the tools and put them on your PATH. Make sure you select F# as one of the languages to install.
2

Install LIQ𝑈𝑖⏐〉

Download the zip file from GitHub (there's a Download Zip button near the top right side of the screen). Then extract the contents into C:\ This will create C:\Liquid-master. Rename the directory to C:\Liquid and you're done!

> dir /b c:\Liquid 
03/01/2016  10:14 AM    <DIR>          .
03/01/2016  10:14 AM    <DIR>          ..
03/01/2016  10:14 AM            10,086 AzureGuide.md
03/01/2016  10:14 AM    <DIR>          bin
03/01/2016  10:14 AM    <DIR>          docs
03/01/2016  10:14 AM            17,292 GettingStarted.md
03/01/2016  10:14 AM    <DIR>          img
03/01/2016  10:14 AM             6,118 LICENSE.md
03/01/2016  10:14 AM    <DIR>          linux
03/01/2016  10:14 AM            32,708 LiquidTikZ.tex
03/01/2016  10:14 AM             5,441 README.md
03/01/2016  10:14 AM    <DIR>          Samples
03/01/2016  10:14 AM    <DIR>          source
03/01/2016  10:14 AM    <DIR>          UserCode
               5 File(s)         71,645 bytes
3

Run the app

Go into the C:\Liquid\bin directory, run the app and accept the license:

> cd \Liquid\bin
> Liquid.exe 
0:0000.0/===================================================================================================
0:0000.0/=    The Language-Integrated Quantum Operations (LIQUi|>) Simulator                               =
0:0000.0/=    is made available under license by Microsoft Corporation                                     =
0:0000.0/=    License terms may be viewed at https://github.com/msr-quarc/Liquid/blob/master/LICENSE.md    =
0:0000.0/=    Please type Y, followed by return, to indicate your acceptance of these terms                =
0:0000.0/===================================================================================================
Y
4

Try a sample

Now try running the Quantum "Hello World" ... Teleport:
(note that there are two underscores in front of Teleport)

> cd \Liquid\bin
> Liquid.exe __Teleport()
1

Install mono and fsharp

Make sure you remove any previous installations of mono or fsharp on your machine to avoid incompatibilities.

Now do the install:

$ sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 3FA7E0328081BFF6A14DA29AA6A19B38D3D831EF
$ echo "deb http://download.mono-project.com/repo/debian wheezy main" | 
            sudo tee /etc/apt/sources.list.d/mono-xamarin.list
$ sudo apt-get update
$ sudo apt-get install mono-complete fsharp
2

Install LIQ𝑈𝑖⏐〉

Download the zip file from GitHub (there's a Download Zip button near the top right side of the screen). Then extract the contents into your home directory. This will create ~/Liquid-master. Copy to the final destination:

$ cd ~/Liquid-master

$ sudo mkdir /Liquid

$ sudo chown $USER /Liquid

$ cp * /Liquid --recursive

3

Run the app

Go into the /Liquid/linux directory, run the app and accept the license:

$ cd /Liquid/linux
$ mono Liquid.exe 
0:0000.0/===================================================================================================
0:0000.0/=    The Language-Integrated Quantum Operations (LIQUi|>) Simulator                               =
0:0000.0/=    is made available under license by Microsoft Corporation                                     =
0:0000.0/=    License terms may be viewed at https://github.com/msr-quarc/Liquid/blob/master/LICENSE.md    =
0:0000.0/=    Please type Y, followed by return, to indicate your acceptance of these terms                =
0:0000.0/===================================================================================================
Y
4

Try a sample

Now try running the Quantum "Hello World" ... Teleport:
(note that there are two underscores in front of Teleport and the program argument has quotation marks because parenthesis are special characters on Linux)

$ cd /Liquid/linux
$ mono Liquid.exe "__Teleport()"
1

Install mono and fsharp

Install mono and F# for OSX from here

2

Install LIQ𝑈𝑖⏐〉

Download the zip file from GitHub (there's a Download Zip button near the top right side of the screen).

  1. You'll find Liquid-master in your Downloads, open the folder.
  2. Type Command-A Command-C to select all the files and copy them.
  3. Type Shift-Command-G and then a slash (/) to go to the root.
  4. Type Shift-Command-N to create a new folder (you will have to enter your admin password). Then create the Liquid folder.
  5. Double click on the Liquid folder to open it and then type Command-V to paste the contents of the downloaded Liquid-master tree into \Liquid.
3

Run the app

Go into the /Liquid/linux directory, run the app and accept the license:

$ cd /Liquid/linux
$ mono Liquid.exe 
0:0000.0/===================================================================================================
0:0000.0/=    The Language-Integrated Quantum Operations (LIQUi|>) Simulator                               =
0:0000.0/=    is made available under license by Microsoft Corporation                                     =
0:0000.0/=    License terms may be viewed at https://github.com/msr-quarc/Liquid/blob/master/LICENSE.md    =
0:0000.0/=    Please type Y, followed by return, to indicate your acceptance of these terms                =
0:0000.0/===================================================================================================
Y
4

Try a sample

Now try running the Quantum "Hello World" ... Teleport:
(note that there are two underscores in front of Teleport and the program argument has quotation marks because parenthesis are special characters on OSX)

$ cd /Liquid/linux
$ mono Liquid.exe "__Teleport()"

And you're set!

You now have LIQ𝑈𝑖⏐〉 running on your machine! You can visit the LIQ𝑈𝑖⏐〉 repo for complete information on writing your own simulations and many built-in samples.