Skip to main content

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

Project description

License GitHub PyPI Contributing pre-commit

title image

🖥️ 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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gurk-2.1.1.tar.gz (141.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

gurk-2.1.1-py3-none-any.whl (224.4 kB view details)

Uploaded Python 3

File details

Details for the file gurk-2.1.1.tar.gz.

File metadata

  • Download URL: gurk-2.1.1.tar.gz
  • Upload date:
  • Size: 141.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for gurk-2.1.1.tar.gz
Algorithm Hash digest
SHA256 b536636ab9d78873813098e534874ed2bc080e62741a777bd69472b5b86265cd
MD5 db85cb119334ca1b328b528e4137d10c
BLAKE2b-256 92d3172aac748734b710ce94800db11596050a6ff94a19af55968022563469d5

See more details on using hashes here.

File details

Details for the file gurk-2.1.1-py3-none-any.whl.

File metadata

  • Download URL: gurk-2.1.1-py3-none-any.whl
  • Upload date:
  • Size: 224.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.15

File hashes

Hashes for gurk-2.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 9d4e9ee331a3c95b016fb24eeaf6cc30baf3b10b7d53a1fbd0c08da0e2c11afc
MD5 c83d97d4a57d0f01845fb75a59fdd550
BLAKE2b-256 d70be466e97995f10e4ef0b5479e35256fcd50c387ae325752289935def77d1f

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page