{"id":9143,"library":"nvalchemi-toolkit-ops","title":"NVALCHEMY Toolkit Ops","description":"NVALCHEMY Toolkit Ops (pypi: `nvalchemi-toolkit-ops`) is a Python library providing high-performance NVIDIA Warp primitives for GPU-enabled computational chemistry and atomistic simulation workflows. It leverages NVIDIA Warp for accelerated calculations. As of version 0.3.1, it is under active development with frequent minor and patch releases, often introducing new features and refactorings.","status":"active","version":"0.3.1","language":"python","source_language":"en","source_url":"https://github.com/NVALCHEMY/toolkit-ops","tags":["GPU","NVIDIA Warp","computational chemistry","atomistic simulation","high-performance computing","chemistry"],"install":[{"cmd":"pip install nvalchemi-toolkit-ops","lang":"bash","label":"Install latest version"}],"dependencies":[{"reason":"Core dependency for Warp GPU computations. Must be installed separately.","package":"nvidia-warp-core","optional":false}],"imports":[{"wrong":"from toolkit_ops.mol_geom import get_bond_length","symbol":"wp","correct":"from nvalchemiops import wp"}],"quickstart":{"code":"import warp as wp\nfrom toolkit_ops.mol_geom import get_bond_length\nimport numpy as np\n\n# Initialize Warp (requires an NVIDIA GPU and CUDA setup)\ntry:\n    wp.init()\nexcept Exception as e:\n    print(f\"Warning: Could not initialize Warp. GPU operations will fail: {e}\")\n    # In a real application, you might exit or provide fallback CPU logic here.\n\n# Example usage:\npositions_np = np.array([\n    [0.0, 0.0, 0.0],\n    [1.0, 0.0, 0.0]\n], dtype=np.float32)\n# Convert numpy array to Warp array\npositions = wp.array(positions_np, dtype=wp.vec3)\n\n# Calculate bond length\nbond_length = get_bond_length(positions, index_0=0, index_1=1)\n\nprint(f\"Calculated bond length: {bond_length.numpy()}\")","lang":"python","description":"This quickstart demonstrates calculating a bond length using `toolkit_ops.mol_geom.get_bond_length`. It initializes NVIDIA Warp, converts a NumPy array of atomic positions to a Warp array, and then performs the calculation. An NVIDIA GPU and CUDA are required for `wp.init()` to succeed."},"warnings":[{"fix":"Always consult the `CHANGELOG.md` or official documentation when upgrading minor versions. Update import paths and API calls accordingly.","message":"Breaking changes are frequent in 0.x.x releases. Version 0.3.0 introduced a restructuring into the `nvalchemy` namespace, and 0.2.0 removed `WarpFFModel` and `WarpNNModel`.","severity":"breaking","affected_versions":"<0.3.0"},{"fix":"Ensure `pip install nvidia-warp-core` is run and your system has a compatible NVIDIA GPU and CUDA toolkit installed. `wp.init()` must execute successfully before using Warp primitives.","message":"NVALCHEMY Toolkit Ops requires an NVIDIA GPU with CUDA installed and properly configured, along with the `nvidia-warp-core` package.","severity":"gotcha","affected_versions":"All"},{"fix":"Use a Python environment that satisfies `Python>=3.11,<3.15` to avoid installation and runtime issues.","message":"Python version compatibility is strict. The library currently requires Python >=3.11 and <3.15.","severity":"gotcha","affected_versions":"All"},{"fix":"Convert NumPy arrays to `warp.array` instances with the appropriate `dtype` (e.g., `wp.vec3`, `wp.float32`) before passing them to `toolkit_ops` functions.","message":"Direct NumPy arrays are not supported as input for most `toolkit_ops` functions. Inputs must first be converted to Warp arrays (e.g., `wp.array(...)`).","severity":"gotcha","affected_versions":"All"}],"env_vars":null,"search_vec":"'0.3.1':43 'acceler':38 'activ':47 'atomist':30,66 'calcul':39 'chemistri':28,65,72 'comput':27,64,71 'develop':48 'enabl':26 'featur':58 'frequent':50 'gpu':25,61 'gpu-en':24 'high':18,69 'high-perform':17,68 'introduc':56 'leverag':34 'librari':15 'minor':51 'new':57 'nvalchemi':1,4,9 'nvalchemi-toolkit-op':8 'nvidia':20,35,62 'often':55 'op':3,6,11 'patch':53 'perform':19,70 'primit':22 'provid':16 'pypi':7 'python':14 'refactor':60 'releas':54 'simul':31,67 'toolkit':2,5,10 'version':42 'warp':21,36,63 'workflow':32","created_at":"2026-04-16T18:48:41.414907+00:00","updated_at":"2026-04-16T18:48:41.414907+00:00","problems":null,"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"0.3.1","cli_name":"","cli_version":null,"type":"library","homepage":null,"github":null,"docs":null,"changelog":null,"pypi":"https://pypi.org/project/nvalchemi-toolkit-ops/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["ai-ml","data"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-30","last_verified":"2026-06-30","next_check":"2026-07-30","install_tag":null}}