Koopera
Koopera is a collaboration app that enables Data Science teams to share and review their jupyter notebooks.
Features
- Review jupyter notebooks by looking at the diffs and commenting directly on the cells
- Review source code with syntax highlight for python, scala, etc. (using diff2html)
- Import notebooks from your GitHub repositories
- Navigate through your notebooks
- GitHub authentication via personal access token
Screenshots
Review jupyter notebooks
Review python code
Import and navigate through your notebooks
Quickstart
You can easily start using Koopera with docker in just two steps.
-
Build and start Koopera + dependencies:
docker-compose up --build -d
-
Run migrations:
docker-compose run --rm koopera alembic upgrade head
When the migration ends, you can now access Koopera at: http://0.0.0.0:8080
Setting up dev environment
Dependencies
- Python 3.6
- nodejs 10
Setting up backend for local development
-
Enable CORS by setting
ALLOW_CORS
toTrue
in src/backend/config.py -
Create virtualenv
python -m venv venv
-
Activate virtualenv
source venv/bin/activate
-
Install dependencies
pip install -r requirements.txt
-
Run migrations
alembic upgrade head
-
Start flask app on default port (5000)
python run.py
Setting up frontend for local development
-
Install dependencies
npm install
-
Run web server for serving frontend
npm run serve
A web server for serving frontend with hot reload will be listening on http://localhost:8080