# Welcome

# **PREREQUISITES**

- Install the clojure cli tools
  Clojure only works on POSIX systems (easily).
  in this case you will need to either have a linux machine, or a mac
  Follow the instructions on [the clojure install
  page](https://clojure.org/guides/install_clojure)
  I will provide simplified instructions
- Install Java. 
  Java versions 8, 11, 17 and 21 are all officially supported. but interim
  releases are also said to work. 
  What is needed for the `java` executable to be on your `$PATH` and
  `$JAVA_HOME` to be set. both of these things can be done by package managers.

## Mac
  
On a Mac with [brew](https://brew.sh/) you can use the `brew` command like
so

``` shell
brew install clojure/tools/clojure
```

There is also an install script made for POSIX systems

``` shell
curl -L -O https://github.com/clojure/brew-install/releases/latest/download/posix-install.sh
chmod +x posix-install.sh
sudo ./posix-install.sh
```

This will create the files `/usr/local/bin/clj`, `/usr/local/bin/clojure`, and the directory `/usr/local/lib/clojure`

## Linux 

The Clojure CLI is available in many package repositories, you can find out
[here](https://repology.org/project/clojure/versions).

For some major distributions:

``` shell
# ubuntu / debian
sudo apt install clojure

# fedora / rhel / centos
sudo dnf install clojure

# arch
sudo pacman -S clojure
```

If you have [linux brew](https://brew.sh) you can use brew like mentioned before

``` shell
brew install clojure/tools/clojure
```

There is also a linux install script

This will create the files `/usr/local/bin/clj`, `/usr/local/bin/clojure`, and the directory `/usr/local/lib/clojure`
``` shell
curl -L -O https://github.com/clojure/brew-install/releases/latest/download/linux-install.sh
chmod +x linux-install.sh
sudo ./linux-install.sh
```

# **RUNNING**

If you have installed the clojure CLI successfully. 

you can then run the program using this command in the root of the project (same
directory as the `deps.edn` file)


This will start the web server on https://localhost:7777 navigate to that to be
able to see the output (which are interactive notebooks). This will also install
all dependencies needed. It will look like its frozen, please wait for a couple
of seconds.

``` shell
clj -X:serve
```

then like said navigate to https://localhost:7777

Instructions will follow from there.