Skip to content
📘 The interactive computing suite for you!
TypeScript Jupyter Notebook Python JavaScript CSS HTML Other
Branch: dev
Clone or download
Pull request Compare This branch is 192 commits ahead, 25 commits behind nteract:master.
Latest commit cf6abe2 Jul 24, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Update circleci/python Docker tag to v3.7.3 Mar 29, 2019
.github Create a github config.yml to set todo bot Apr 2, 2019
.vscode
applications Merge branch 'master' of https://github.com/nteract/nteract into feat… Jul 22, 2019
doc rely on ts-jest without checking types Jan 6, 2019
initiatives httpsify some urls (nteract#3139) Jul 29, 2018
nteract-packages Fix bugs in package docs deployment Dec 4, 2018
packages Merge branch 'master' of https://github.com/nteract/nteract into feat… Jul 22, 2019
pdnd-tutorials First documentation and Docker integration Mar 22, 2019
scripts add hack in test-shim for HTMLCanvasElement Jan 18, 2019
styleguide-components move styleguide components to separate standalone Jan 4, 2019
styleguide semi-automate deployment of style guide May 31, 2018
types Add vega-embed-v3 as embedder for vega@3/vega-lite@2 Jul 16, 2019
.eslintignore Depreacate @nteract/gatsby-transformer-ipynb package Jan 18, 2019
.gitattributes chore: normalize line endings Dec 11, 2016
.gitignore clean up remaining references to flow Jan 5, 2019
.npmignore Use yarn Apr 30, 2017
.pre-commit-config.yaml add auto lint jupyter-extension Feb 1, 2019
.prettierignore Reorganize applications and packages (nteract#2149) Dec 14, 2017
.prettierrc create a prettierrc Mar 29, 2018
AUTHORS New publiccode.yml and AUTHORS files May 31, 2019
CHANGELOG.md noting jext support for Python < 3.6 Sep 10, 2018
CODE_OF_CONDUCT.md Update CODE_OF_CONDUCT.md Sep 4, 2018
CONTRIBUTING.md Add docs on NodeJS LTS version Jan 18, 2019
LICENSE fix attribution clause Dec 16, 2017
README-nteract.md First documentation and Docker integration Mar 22, 2019
README.md Merge branch 'daf-develop' of github.com:teamdigitale/daf-nteract int… Jul 22, 2019
RELEASING.md
USER_GUIDE.md Add desktop command line and environment variable documentation. Oct 29, 2018
azure-pipelines.yml disable testing on azure Jan 29, 2019
codecov.yml Disable codecov being required to pass Oct 5, 2017
dockerfile Updates dockerfile, yarn.lock Jul 22, 2019
lerna.json lerna version in lerna.json is no longer necessary Sep 7, 2018
package-lock.json Clean up types and remove unneeded changes Jul 2, 2019
package.json Merge pull request nteract#4441 from nteract/renovate/css-loader-3.x Jul 22, 2019
publiccode.yml Remove localizedName Jun 17, 2019
renovate.json remove lockfile maintenance Aug 7, 2018
styleguide.config.js Fix regexp for windows paths Jun 28, 2019
tsconfig.base.json add plugin for styled-components Jan 20, 2019
tsconfig.jest.json clean up some of the old tests Jan 7, 2019
tsconfig.json Bring back chunks for jext's ts-loader Jan 30, 2019
tslint.json remove excessively protective tslint typedef rules Jan 31, 2019
typedoc.js
yarn.lock Updates dockerfile, yarn.lock Jul 22, 2019

README.md

PDND-nteract

This is a branched (daf-*) fork of nteract, a react user interface on top of jupyter server. We have developed an integration of the API from PDND - DAF (Piattaforma Digitale Nazionale Dati) for simplyfing the access to Italian public data inside notebook for data analysis. We are developing a set of UI components integrated into a set of API to read, save and update data into PDND - DAF. As in the image below

search components

the user can search dataset from PDND - DAF load into a dataframe and starting working on it. The tool is very powerful and flexible and can be an easy way to start working on public dataset from italian administrations, making simple analysis and reports.

Tutorials

Once installed on you local machine, you can read a simple tutorial for understanding the basic functionalities implemented. In the next releases we will provide more functionalities and tutorials. If you want to contribute with only suggestions use this repo, opening issues and following our project and milestone.

Getting Started

There are three ways to get you a copy of the project up and running on your local machine depending on your purpose:

Docker

Docker MUST be installed on your local machine

From dockerhub

docker pull teamdigitale/daf-nteract
docker run -p 8888:8888 teamdigitale/daf-nteract

or from your local build

git clone git@github.com:teamdigitale/daf-nteract.git
cd nteract
docker build -t pdnd-nteract .
docker run -p 8888:8888 pdnd-nteract

Save the token from the output of your console as: http://(b4fd9e3ef290 or 127.0.0.1):8888/?token=XXXXXXXXXXXXXX and open your browser at [http://localhost:8888]. If you are asked the token paste it.

Install for data analyst

If you are a data scientist we have realeased pdnd-open-notebooks repository based on this work on nteract. It provides a ready to use datascience Docker with libraries for python, R and julia.

Otherwise, you can use this repo as your favorite tool for anlysing Italian public dataset you can follow these steps:

Requires Node.js, yarn, lerna python 3 and pip on python 3. The following steps are for MacOs only but can be adjusted for different operating systems.

git clone git@github.com:teamdigitale/daf-nteract.git
cd nteract
pip3 install jupyter requests pandas fbprophet
npm install --global lerna
brew install yarn
yarn install
cd applications/jupyter-extension
pip3 install -e .
jupyter serverextension enable nteract_on_jupyter
lerna run build:asap --scope nteract-on-jupyter --stream
cd YOUR_LOCAL_FODER_TO_SAVE_OR_LOAD_NOTEBOOKS
jupyter nteract

Install for contributing

If you want to contribute to the project, we suggest to follow the contrubuting guidelines of nteract. We have public milestones and project on github for looking at our current work. Nteract is build using typescript react redux rx-js and is a very active project. If you are willing to work on such technolgies can be a really good start and we are very open to create a community around our integration.

Requires Node.js, yarn, lerna python 3 and pip on python 3.

MacOS

git clone git@github.com:teamdigitale/daf-nteract.git
cd nteract
pip3 install jupyter requests pandas fbprophet
brew install yarn
yarn install
cd applications/jupyter-extension
pip3 install -e .
jupyter serverextension enable nteract_on_jupyter
cd YOUR_LOCAL_FODER_TO_SAVE_OR_LOAD_NOTEBOOKS
jupyter nteract --dev

Ubuntu or Debian

git clone git@github.com:teamdigitale/daf-nteract.git
cd nteract
pip3 install jupyter requests pandas fbprophet

# YARN INSTALLATION
curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -
echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list
sudo apt-get update && sudo apt-get install yarn

# NODEJS INSTALLATION
curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -
sudo apt-get install -y nodejs

yarn install
cd applications/jupyter-extension
pip3 install -e .
jupyter serverextension enable nteract_on_jupyter
cd YOUR_LOCAL_FODER_TO_SAVE_OR_LOAD_NOTEBOOKS
jupyter nteract --dev

Windows

If you are on Windows 10, you can activate Ubuntu on the Windows Subsystem for Linux and follow the same steps as above.

Almost the main things developed are inside the pdnd-nteract-packages

You can’t perform that action at this time.