Commit 9aa45b10 authored by Alexandre Delanoë's avatar Alexandre Delanoë

[DOC] README update

parent cae0bfb2
Pipeline #1638 passed with stage
in 24 minutes and 27 seconds
# Gargantext Haskell # Gargantext with Haskell (Backend instance)
## About this project ## About the project
Gargantext is a collaborative web platform for the exploration of sets GarganText is a collaborative web-decentralized-based macro-service
of unstructured documents. It combines tools from natural language platform for the exploration of unstructured texts. It combines tools
processing, text-mining, complex networks analysis and interactive data from natural language processing, text-data-mining tricks, complex
visualization to pave the way toward new kinds of interactions with your networks analysis algorithms and interactive data visualization tools to
digital corpora. This software is a free software, developed by the CNRS pave the way toward new kinds of interactions with your digital corpora.
This software is free software, developed and offered by the CNRS
Complex Systems Institute of Paris Île-de-France (ISC-PIF) and its Complex Systems Institute of Paris Île-de-France (ISC-PIF) and its
partners. partners.
GarganText Project: this repo builds the
backend for the frontend server built by
[backend](https://gitlab.iscpif.fr/gargantext/haskell-gargantext).
## Installation ## Installation
Disclaimer: this project is still in development, this is work in Disclaimer: this project is still in development, this is work in
progress. Please report and improve this documentation if you encounter issues. progress. Please report and improve this documentation if you encounter issues.
### Stack setup
You need to install stack first:
```shell
curl -sSL https://get.haskellstack.org/ | sh
```
Verify the installation is complete with
```shell
stack --version
```
### With Nix setup
First install [nix](https://nixos.org/guides/install-nix.html):
```shell
sh < (curl -L https://nixos.org/nix/install) --daemon
```
Verify the installation is complete
```shell
$ nix-env
nix-env (Nix) 2.3.12
```
And just build:
``` sh
stack --nix build --fast
```
### Build Core Code ### Build Core Code
NOTE: Default build (with optimizations) requires large amounts of RAM (16GB at least). To avoid heavy compilation times and swapping out your machine, it is recommended to `stack build` with the `--fast-` flag, i.e.: NOTE: Default build (with optimizations) requires large amounts of RAM
(16GB at least). To avoid heavy compilation times and swapping out your
machine, it is recommended to `stack build` with the `--fast-` flag,
i.e.:
``` sh ``` sh
stack --docker build --fast stack --nix build --fast
``` ```
or or
``` sh ``` sh
stack --nix build --fast stack --docker build --fast
``` ```
This might be related to the [broken Swagger `-O2` issue](https://github.com/haskell-servant/servant/issues/986).
#### Docker #### Docker
...@@ -53,15 +95,6 @@ curl -sSL https://gitlab.iscpif.fr/gargantext/haskell-gargantext/raw/dev/devops/ ...@@ -53,15 +95,6 @@ curl -sSL https://gitlab.iscpif.fr/gargantext/haskell-gargantext/raw/dev/devops/
./devops/install-corenlp ./devops/install-corenlp
``` ```
2. Louvain C++ needed to draw the socio-semantic graphs
NOTE: This is already added in the Docker build.
``` sh
git clone https://gitlab.iscpif.fr/gargantext/clustering-louvain-cplusplus.git
cd clustering-louvain-cplusplus
./install
```
### Initialization ### Initialization
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment