Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pink-gorilla/notebook
Web based Clojure notebook application/-library.
https://github.com/pink-gorilla/notebook
clojure clojurescript codemirror data-science gorilla-notebook gorilla-repl pink-gorilla re-frame reagent vega
Last synced: about 2 months ago
JSON representation
Web based Clojure notebook application/-library.
- Host: GitHub
- URL: https://github.com/pink-gorilla/notebook
- Owner: pink-gorilla
- Created: 2017-01-11T12:49:39.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2021-06-27T01:08:26.000Z (about 3 years ago)
- Last Synced: 2024-05-23T10:16:02.892Z (4 months ago)
- Topics: clojure, clojurescript, codemirror, data-science, gorilla-notebook, gorilla-repl, pink-gorilla, re-frame, reagent, vega
- Language: Clojure
- Homepage: https://pink-gorilla.github.io/
- Size: 36.1 MB
- Stars: 102
- Watchers: 9
- Forks: 9
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Pink Gorilla Notebook [](https://github.com/pink-gorilla/notebook/actions?workflow=CI)
[](https://clojars.org/org.pinkgorilla/notebook)
[](https://clojars.org/org.pinkgorilla/notebook-bundel)
Pink Gorilla Notebook is a rich browser based notebook REPL for Clojure and ClojureScript, which aims at extensibility
(development- and runtime) and user experience while being very lightweight. Extensibility primarily revolves around
UI vizulisations and data.
### Use cases
- Data science
- Persistent experiments and demos (Clojure/ClojureScript libraries)
- Courses and education on all matters related to clojure
### Web Interface
Whichever method you use to start the notebook, you should reach it at [`http://localhost:8000/`](http://localhost:8000/).
## Run Notebook standalone
The easiest way to run the notebook locally is leveraging the `clojure` cli
```
clojure -Sdeps '{:deps {org.pinkgorilla/notebook-bundel {:mvn/version "RELEASE"}}}' -m pinkgorilla.notebook-bundel
```
## Run Notebook with **default bundel**
Since the default bundel ships many default ui extensions, you want to use the **notebook-bundel**
artefact, because the javascript frotend app has already been precompiled, which results in faster startup-time.
### in your deps.edn project
We recommend to use tools.deps over leiningen fortwo reasons:
- no dependency coflicts with tools.deps (tools deps resolves to the highest dependency version, vs leiningen which depends on the position in the project.clj
- use RELEASE so you always get the most recent notebook)
One way to configure the notebook is to pass it a edn configuration file. An example is
[notebook edn config](https://github.com/pink-gorilla/notebook/blob/master/resources/notebook-core.edn)
In your deps.edn add this alias:
```
:notebook {:extra-deps {org.pinkgorilla/notebook-bundel {:mvn/version "RELEASE"}}
:exec-fn pinkgorilla.notebook-bundel/run
:exec-args {:config "notebook-config.edn"}}
```
then run it with `clojure -X:notebook`.
[trateg](https://github.com/clojure-quant/trateg) uses notebook-bundel with deps.edn:
Clone trateg and run `clojure -X:notebook`
### in your leiningen project
** We don't recommend leiningen use with notebook, as leiningen does not use the highest version of dependencies. **
## Run Notebook with **custom bundel**
If you define your own ui extensions, you need to compile the javascript bundel.
This requires some extra initial compilation time.
### in your deps.edn project
[ui-quil](https://github.com/pink-gorilla/ui-quil) use deps.edn to build a custom notebook
bundel (that includes the library that gets built).
### in your leiningen project
[gorilla-ui](https://github.com/pink-gorilla/gorilla-ui) and
[ui-vega](https://github.com/pink-gorilla/ui-vega) use leiningen to run notebooks with a
custom build bundel, and with custom notebook folder.
## Run Notebook in Docker Image
Documentation has been moved [over here](https://pink-gorilla.github.io/)
[](https://microbadger.com/images/pinkgorillawb/gorilla-notebook "Get your own version badge on microbadger.com")
[](https://microbadger.com/images/pinkgorillawb/gorilla-notebook "Get your own image badge on microbadger.com")
## Run Notebook from cloned git repo
This option is mainly there for development of notebook.
For regular use, the long compile-times are not really sensible.
Run `clojure -X:notebook` to run the notebook.
This runs the notebook with ui libraries bundled:
- gorilla ui
- gorilla plot
## Run Development UI
Run `clojure -X:develop` to run the develop ui.
## Licence
Gorilla is licensed to you under the MIT licence. See LICENCE.txt for details.
Copyright © 2019- Jony Hudson, Andreas Steffan and contributors