gurk 2.1.0

Contains anything related to setting up a new computer (desktop) system

🖥️ gurk 🥒 - The user-friendly package manager allowing customizable and repeatable computer setup

Installation (Ubuntu 22.04+ only)

Please use the provided installation script (recommended):

sudo apt update && sudo apt install curl
curl -fsSL https://raw.githubusercontent.com/ArturoRoberti/gurk/main/install.sh | sudo bash

or follow the instructions in the Installation Guide.

Usage

Using gurk you can run various plugins and tasks via

gurk run <plugin>[:<option> | /<task-subname>] [<task-args>]

where <plugin> is a plugin's git URL, the name of an installed plugin or a local path to a custom plugin. Please have a brief look at the documentation for more information.

Examples

Install docker via the docker plugin:

gurk run docker/install-docker

Install conda via the conda plugin:

gurk run conda/install-conda

See available arguments for the conda plugin:

gurk run conda --help  # OR 'gurk run conda/install-conda --help' for the specific task

Run the example plugin, which installs and configures multiple programs commonly used:

gurk run 'https://github.com/ArturoRoberti/gurk_example_plugin.git:setup'

Contributing

Please see CONTRIBUTING.md for contribution guidelines.

License

This project is licensed under the Apache 2.0 License - see the LICENSE file for details.

TODO

Please see TODO.md for a list of planned improvements and features.