Skip to main content

NIX-ML : Easy, reproducible, environments with Nix + YAML

Simple, perfectly reproducible, environments with nix specified using an YAML file.

Example, write to a file called env.nml:

nixml: v0.0
snapshot: stable-19.03
packages:
  - lang: python
    version: 2
    modules:
      - numpy
      - scipy
      - matplotlib
      - mahotas
      - jupyter
      - scikitlearn

Now, run

nixml shell

and you will be dropped into an environment containing the packages listed above, as was up to date in March 2019. Conceptually, the environment will always be generated from scratch, but caching means that the first time will take significantly longer (including, it will download all dependencies). Afterwards, it should take a few seconds at most.

This environment will be like a typical conda/pip/virtualenv/... environment: if will place the corresponding binaries at the front of the PATH so that they are picked with high priority, but, alternatively, you can generate a pure environment, which will contain only the packages that you specify. This avoids accidental use of packages that are not part of the environment:

nixml shell --pure

Finally, you can run

nixml generate

to just create the nixml.nix corresponding to the enviroment.

Dependencies

NIXML Format

It's a YaML file

nixml: version of nixml to use. Currently, only v0.0 is supported.

snapshot: This is the package version to use. Currently, only stable-19.03 is available, but general syntax is {stable,unstable}-{year}.{month}.

packages: A list of packages, which are grouped into language blocks. Currently supported:

  • python: Python language environment, specify the version (version) and modules.
  • texlive: Texlive packages
  • nix: Generic packages (i.e., vim or bash)

Author

Metadata

Release files for nixml 0.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nixml 0.2
File Size Uploaded
nixml-0.2.tar.gz 8.4 kB Details

Release files / nixml-0.2.tar.gz

Download URL nixml-0.2.tar.gz
Size 8.4 kB
Tags Source
SHA-256 checksum
How to use checksums
137bb2ef96c0832d9b38fabe2aa6616a30797c2012ec35f503887163f13aa442
BLAKE2b-256 checksum
How to use checksums
eb623bf55953ae8655dcaf1dd7da35e7f88078e1bd79bd573548f25a3d274ea9
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/1.13.0 pkginfo/1.4.2 requests/2.20.1 setuptools/40.4.0 requests-toolbelt/0.9.1 tqdm/4.26.0 CPython/3.6.8

Release history Release notifications | RSS feed

This release

0.2 This release

1 release file

0.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page