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 follow the instructions in the Installation Guide or use the provided installation script:

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

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.0.8.tar.gz (137.3 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.0.8-py3-none-any.whl (218.4 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for gurk-2.0.8.tar.gz
Algorithm Hash digest
SHA256 9fb3a752a0f44a3ce1161bf7ac57d2fce35a677537ee437f974f9090992645b9
MD5 a7c168eab58ad69ee5e3674d69e5de1c
BLAKE2b-256 2259393614ac8e8672a8c6da30e52a289cfd474cfb2ab99549e30577b6cb1f91

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for gurk-2.0.8-py3-none-any.whl
Algorithm Hash digest
SHA256 e9327469d54915d9e836d65008148fc49ceace4e2abf725b61aaac6e74212efa
MD5 675b12805513f61423ac6c2098bfb1fc
BLAKE2b-256 9683535748aecc538188b20f360d55149d2b52972ae9b7fbefed6d8545e6429e

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