qmamba is a package manager for kdb-x, built using libmamba.
It enables users to download and install kdb-x modules from inside a q session with a simple command. The modules can be sourced from the KX channel as prebuilt packages and qmamba will automatically fetch any dependencies (such as third party libraries) from other channels such as conda-forge.
It also supports having multiple independent environments into which packages are installed and allows the user to switch between these environments.
It is recommended that qmamba is installed using one of the release packages.
- Linux or macOS (Windows support is planned)
- kdb+ ≥ 5.0 64-bit
-
Download a release for your OS and system architecture.
-
Unzip the download.
-
From the extracted
qmamba/directory, run the installation script:## Linux/macOS ## By default kdb-x is installed to ~/.kx ./install.sh <path to kdb-x installation> ## Windows install.bat <path to kdb-x installation>
-
On macOS you may need to clear Apple’s quarantine attribute from the
.so, e.g.xattr -d com.apple.quarantine ~/.kx/mod/kx/qmamba/clib.ma64.so
- Follow the instructions to build qmamba from source.
- Run the installation script (same as above) from the package install directory that was created by the build.
The complete set of documentation is split over over several pages for ease of readability. Users new to qmamba should read them in order.
- Introduction to qmamba
- Basic concepts such as packages, channels and environments
- Getting started with a tour of the basic functionality
- Learning more about qmamba and how to use it
- Function reference including options, shortcuts and a simple example for each API
- Configuration options which can be used to change some of the defaults which qmamba uses
- Common usage patterns such cloning an environment
- Use in airgapped environment including how to create a local conda channel with cloned packages
- Mamba and Conda provides more detailed information on these, and how they are used by qmamba
- Troubleshooting guide for identifying and resolving common issues
The qmamba interface is provided here under an Apache 2.0 license. It is built using libmamba, its licenses are included in the licenses folder.
If you find issues with the interface or have feature requests, please consider raising an issue.
If you wish to contribute to this project, please follow the contribution guide.