mirror of
https://github.com/qmk/qmk_cli.git
synced 2026-07-25 16:42:55 -04:00
Agathe
93e629608e
The setuptools dependency is not needed in this file because setuptools will be installed from the pyproject.toml file. Since the project does not use anything from the setuptools package, remove it as a dependency. This fixes the following bug in Debian: https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=1083736
QMK CLI
A program to help users work with QMK Firmware.
Features
- Interact with your qmk_firmware tree from any location
- Use
qmk cloneto pull down anyone'sqmk_firmwarefork - Setup your build environment with
qmk setup - Use
qmk consoleto get debugging information from your keyboard(s) - Check that your environment is correctly setup with
qmk doctor - Integrates with qmk_firmware for additional functionality:
qmk compileqmk infoqmk flashqmk lint- ...and many more!
Packages
We provide "install and go" packages for many Operating Systems.
Linux
Packages for several distributions available here: https://github.com/qmk/qmk_fpm
macOS
Using Homebrew:
brew install qmk/qmk/qmk
Windows
Download our custom MSYS2 installer here: https://msys.qmk.fm/
Quickstart
python3 -m pip install qmkqmk setup
Building
We follow PEP517, you can install using build:
Setup:
python3 -m pip install build
Build:
python3 -m build
You can read more about working with PEP517 packages in the Python Packaging User Guide.
Documentation
Full documentation: https://docs.qmk.fm/#/tutorial