The Renku Project Documentation¶
Renku (連句 “linked verses”), is a Japanese form of popular collaborative linked verse poetry, written by more than one author working together.*
The Renku Project is a platform that bundles together various tools for reproducible and collaborative data analysis projects. It is aimed at independent researchers and data scientists as well as labs, collaborations, and courses and workshops. Renku can be used by anyone who deals with data, whether they are a researcher, data analyst, project owner, or data provider.
Renku promotes reproducibility by providing tools to track your analysis workflows and save them together with your versioned data, code, and environment specification. Every result can be replayed either to repeat a calculation or to re-execute on new data or with a different choice of parameters.
Renku encourages reusability by storing and querying the connections between datasets, code executions, and results in a Knowledge Graph. Producers and consumers of analysis artifacts can always recover the full provenance of a result, establishing trust and reducing boilerplate.
Renku stimulates collaboration among peers and across disciplines by guaranteeing that a media-rich discussion space and fully configured, shareable interactive computational environments are always just a click away. Collaborators can easily work on projects together or in parallel, combining their work in a systematic and safe manner.
A public instance of RenkuLab is available at https://renkulab.io, and there are several other deployments at various institutions. To start exploring Renku, feel free to make an account and try it out! You can follow the first steps tutorial or continue reading about the Renku project.
We’re happy to receive contributions of all kinds, whether it is an idea for a new feature, a bug report or a pull request!
Please review our contributing guidelines before submitting a pull request.
Getting in touch¶
There are several channels you can use to communicate with us; we monitor all of them, so your messages will always get to us, but communication will be slightly more streamlined if you pick a channel that most suits your purpose and needs.
- discourse: questions concerning renkulab or renku CLI usage, release notes
- github & renku (CLI): create platform-usability and software-bug issues
- gitter: communicate with the team
Renku is developed as an open source project by the Swiss Data Science Center in a team split between EPFL and ETHZ.
The Renku project consists of several sub-repositories:
- renku-gateway: a simple API gateway
- renku-graph: Knowledge Graph services
- renku-notebooks: a lightweight service for handling interactive notebooks through JupyterHub
- renku-jupyter: base images for interactive sessions
- renku-python: the Python CLI, SDK, and core backend service
- renku-ui: web front-end
- renku-project-templates: base templates used for instantiating renku projects.
- renkulab-docker: docker images used for renku interactive environments.