Nim toolchain manager, forked from choosenim
Go to file
Rasmus Moorats 5422f1c2e0
rebrand from choosenim to getnim
2023-05-08 14:28:36 +03:00
bin Add tester. 2017-04-30 16:48:33 +01:00
scripts rebrand from choosenim to getnim 2023-05-08 14:28:36 +03:00
src rebrand from choosenim to getnim 2023-05-08 14:28:36 +03:00
tests rebrand from choosenim to getnim 2023-05-08 14:28:36 +03:00
.gitignore rebrand from choosenim to getnim 2023-05-08 14:28:36 +03:00
LICENSE Add LICENSE file 2017-09-07 23:44:48 +01:00
changelog.markdown Bump version to 0.8.4 2022-07-06 14:51:25 +01:00
getnim.nimble rebrand from choosenim to getnim 2023-05-08 14:28:36 +03:00 rebrand from choosenim to getnim 2023-05-08 14:28:36 +03:00


getnim installs the Nim programming language from official downloads and sources, enabling you to easily switch between stable and development compilers.

The aim of this tool is two-fold:

  • Provide an easy way to install the Nim compiler and tools.
  • Manage multiple Nim installations and allow them to be selected on-demand.

Typical usage

To select the current stable release of Nim:

$ getnim stable
  Installed component 'nim'
  Installed component 'nimble'
  Installed component 'nimgrep'
  Installed component 'nimpretty'
  Installed component 'nimsuggest'
  Installed component 'testament'
   Switched to Nim 1.0.0
$ nim -v
Nim Compiler Version 1.0.0 [Linux: amd64]

To update to the latest stable release of Nim:

$ getnim update stable

To display which versions are currently installed:

$ getnim show
  Selected: 1.6.6
   Channel: stable
      Path: /home/xx/.getnim/toolchains/nim-1.6.6

          * 1.6.6

Versions can be selected via getnim 1.6.6 or by branch/tag name via getnim #devel (note that selecting branches is likely to require Nim to be bootstrapped which may be slow).



Download the latest Windows version from the releases page (the .zip file, for example here is v0.7.4).

Extract the zip archive and run the runme.bat script. Follow any on screen prompts and enjoy your new Nim and getnim installation.

There is also a third-party project to provide an installer for getnim, you can find it here (note that this isn't vetted by the Nim team so you do so at your own risk).


curl -sSf | sh
wget -qO - | sh

Optional: You can specify the initial version you would like the script to install by specifying the GETNIM_CHOOSE_VERSION environment variable.

How getnim works

Similar to the likes of rustup and pyenv, getnim is a toolchain multiplexer. It installs and manages multiple Nim toolchains and presents them all through a single set of tools installed in ~/.nimble/bin.

The nim, nimble and other tools installed in ~/.nimble/bin are proxies that delegate to the real toolchain. getnim then allows you to change the active toolchain by reconfiguring the behaviour of the proxies.

The toolchains themselves are installed into ~/.getnim/toolchains. For example running nim will execute the proxy in ~/.nimble/bin/nim, which in turn will run the compiler in ~/.getnim/toolchains/nim-1.0.0/bin/nim, assuming that 1.0.0 was selected.

How toolchains are installed

getnim downloads and installs the official release binaries on Windows and Linux. On other platforms, the official source release is downloaded and built. This operation is only performed once when a new version is selected.

As official binaries are made available for more platforms, getnim will install them accordingly.


Windows Linux macOS (*)
C compiler Downloaded automatically gcc/clang gcc/clang
curl N/A Any recent version (※) Any recent version

* Many macOS dependencies should already be installed. You may need to install a C compiler however. More information on dependencies is available here.

※ Some users needed to install libcurl4-gnutls-dev (see here)

Git is required when installing #HEAD or a specific commit of Nim. The unxz binary is optional but will allow getnim to download the smallest tarballs.


> getnim -h
getnim: The Nim toolchain installer.

  getnim <version/path/channel>

  getnim 1.0.0
    Installs (if necessary) and selects version 0.16.0 of Nim.
  getnim stable
    Installs (if necessary) Nim from the stable channel (latest stable release)
    and then selects it.
  getnim #head
    Installs (if necessary) and selects the latest current commit of Nim.
    Warning: Your shell may need quotes around `#head`: getnim "#head".
  getnim ~/projects/nim
    Selects the specified Nim installation.
  getnim update stable
    Updates the version installed on the stable release channel.
  getnim versions [--installed]
    Lists the available versions of Nim that getnim has access to.

    Describes the latest stable release of Nim.
    Describes the latest development (or nightly) release of Nim taken from
    the devel branch.

  update    <version/channel>    Installs the latest release of the specified
                                 version or channel.
  show                           Displays the selected version and channel.
  show      path                 Prints only the path of the current Nim version.
  update    self                 Updates getnim itself.
  versions  [--installed]        Lists available versions of Nim, passing
                                 `--installed` only displays versions that
                                 are installed locally (no network requests).

  -h --help             Show this output.
  -y --yes              Agree to every question.
  --version             Show version.
  --verbose             Show low (and higher) priority output.
  --debug               Show debug (and higher) priority output.
  --noColor             Don't colorise output.

  --getnimDir:<dir>  Specify the directory where toolchains should be
                        installed. Default: ~/.getnim.
  --nimbleDir:<dir>     Specify the Nimble directory where binaries will be
                        placed. Default: ~/.nimble.
  --firstInstall        Used by install script.