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

Uploaded Python 3

File details

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

File metadata

  • Download URL: gurk-2.0.7.tar.gz
  • Upload date:
  • Size: 137.5 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.7.tar.gz
Algorithm Hash digest
SHA256 890080467a65e87b94639b38e0984266dc7d2e75cff214f45e530b259aeca78a
MD5 4553f80ffd7038cb2f968805d99a4517
BLAKE2b-256 0122738bf343a6010f8d18c793958d683a9116a07c5c645da5ce9794b3a16d74

See more details on using hashes here.

File details

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

File metadata

  • Download URL: gurk-2.0.7-py3-none-any.whl
  • Upload date:
  • Size: 218.5 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.7-py3-none-any.whl
Algorithm Hash digest
SHA256 bb6d156a8e887481a8d7d8287dcc027cacdb059e345534cdaa0649bf17443c8d
MD5 f94e80b3913d39dcc37b3d5639768c11
BLAKE2b-256 381dfad6f71587726e981beba9a7023e80c548e5b63ac4519c0212bb2c5659c0

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