bitsandbytes/pr_1349/en/errors.html

<meta charset="utf-8" /><meta name="hf:doc:metadata" content="{&quot;title&quot;:&quot;Troubleshoot&quot;,&quot;local&quot;:&quot;troubleshoot&quot;,&quot;sections&quot;:[{&quot;title&quot;:&quot;No kernel image available&quot;,&quot;local&quot;:&quot;no-kernel-image-available&quot;,&quot;sections&quot;:[],&quot;depth&quot;:2},{&quot;title&quot;:&quot;fatbinwrap&quot;,&quot;local&quot;:&quot;fatbinwrap&quot;,&quot;sections&quot;:[],&quot;depth&quot;:2}],&quot;depth&quot;:1}">
		<link href="/docs/bitsandbytes/pr_1349/en/_app/immutable/assets/0.e3b0c442.css" rel="modulepreload">
		<link rel="modulepreload" href="/docs/bitsandbytes/pr_1349/en/_app/immutable/entry/start.49de2a9e.js">
		<link rel="modulepreload" href="/docs/bitsandbytes/pr_1349/en/_app/immutable/chunks/scheduler.852ec091.js">
		<link rel="modulepreload" href="/docs/bitsandbytes/pr_1349/en/_app/immutable/chunks/singletons.9fa8504b.js">
		<link rel="modulepreload" href="/docs/bitsandbytes/pr_1349/en/_app/immutable/chunks/index.268e315a.js">
		<link rel="modulepreload" href="/docs/bitsandbytes/pr_1349/en/_app/immutable/chunks/paths.c3e4f46a.js">
		<link rel="modulepreload" href="/docs/bitsandbytes/pr_1349/en/_app/immutable/entry/app.71938ec3.js">
		<link rel="modulepreload" href="/docs/bitsandbytes/pr_1349/en/_app/immutable/chunks/index.28275fd3.js">
		<link rel="modulepreload" href="/docs/bitsandbytes/pr_1349/en/_app/immutable/nodes/0.a120084e.js">
		<link rel="modulepreload" href="/docs/bitsandbytes/pr_1349/en/_app/immutable/chunks/each.e59479a4.js">
		<link rel="modulepreload" href="/docs/bitsandbytes/pr_1349/en/_app/immutable/nodes/4.7380d9f9.js">
		<link rel="modulepreload" href="/docs/bitsandbytes/pr_1349/en/_app/immutable/chunks/CodeBlock.c3366071.js">
		<link rel="modulepreload" href="/docs/bitsandbytes/pr_1349/en/_app/immutable/chunks/EditOnGithub.582011f0.js"><!-- HEAD_svelte-u9bgzb_START --><meta name="hf:doc:metadata" content="{&quot;title&quot;:&quot;Troubleshoot&quot;,&quot;local&quot;:&quot;troubleshoot&quot;,&quot;sections&quot;:[{&quot;title&quot;:&quot;No kernel image available&quot;,&quot;local&quot;:&quot;no-kernel-image-available&quot;,&quot;sections&quot;:[],&quot;depth&quot;:2},{&quot;title&quot;:&quot;fatbinwrap&quot;,&quot;local&quot;:&quot;fatbinwrap&quot;,&quot;sections&quot;:[],&quot;depth&quot;:2}],&quot;depth&quot;:1}"><!-- HEAD_svelte-u9bgzb_END -->      <p></p>  <h1 class="relative group"><a id="troubleshoot" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#troubleshoot"><span><svg class="" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg></span></a> <span>Troubleshoot</span></h1>  <h2 class="relative group"><a id="no-kernel-image-available" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#no-kernel-image-available"><span><svg class="" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg></span></a> <span>No kernel image available</span></h2> <p data-svelte-h="svelte-1imk262">This problem arises with the cuda version loaded by bitsandbytes is not supported by your GPU, or if you pytorch CUDA version mismatches.</p> <p data-svelte-h="svelte-dh1mu2">To solve this problem you need to debug <code>$LD_LIBRARY_PATH</code>, <code>$CUDA_HOME</code> as well as <code>$PATH</code>. You can print these via <code>echo $PATH</code>. You should look for multiple paths to different CUDA versions. This can include versions in your anaconda path, for example <code>$HOME/anaconda3/lib</code>. You can check those versions via <code>ls -l $HOME/anaconda3/lib/*cuda*</code> or equivalent paths. Look at the CUDA versions of files in these paths. Does it match with <code>nvidia-smi</code>?</p> <p data-svelte-h="svelte-wpk6vc">If you are feeling lucky, you can also try to compile the library from source. This can be still problematic if your PATH variables have multiple cuda versions. As such, it is recommended to figure out path conflicts before you proceed with compilation.</p>  <h2 class="relative group"><a id="fatbinwrap" class="header-link block pr-1.5 text-lg no-hover:hidden with-hover:absolute with-hover:p-1.5 with-hover:opacity-0 with-hover:group-hover:opacity-100 with-hover:right-full" href="#fatbinwrap"><span><svg class="" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 256"><path d="M167.594 88.393a8.001 8.001 0 0 1 0 11.314l-67.882 67.882a8 8 0 1 1-11.314-11.315l67.882-67.881a8.003 8.003 0 0 1 11.314 0zm-28.287 84.86l-28.284 28.284a40 40 0 0 1-56.567-56.567l28.284-28.284a8 8 0 0 0-11.315-11.315l-28.284 28.284a56 56 0 0 0 79.196 79.197l28.285-28.285a8 8 0 1 0-11.315-11.314zM212.852 43.14a56.002 56.002 0 0 0-79.196 0l-28.284 28.284a8 8 0 1 0 11.314 11.314l28.284-28.284a40 40 0 0 1 56.568 56.567l-28.285 28.285a8 8 0 0 0 11.315 11.314l28.284-28.284a56.065 56.065 0 0 0 0-79.196z" fill="currentColor"></path></svg></span></a> <span>fatbinwrap</span></h2> <p data-svelte-h="svelte-ymf2uv">This error occurs if there is a mismatch between CUDA versions in the C++ library and the CUDA part. Make sure you have right CUDA in your <code>$PATH</code> and <code>$LD_LIBRARY_PATH</code> variable. In the conda base environment you can find the library under:</p> <div class="code-block relative"><div class="absolute top-2.5 right-4"><button class="inline-flex items-center relative text-sm focus:text-green-500 cursor-pointer focus:outline-none transition duration-200 ease-in-out opacity-0 mx-0.5   text-gray-600 " title="code excerpt" type="button"><svg class="" xmlns="http://www.w3.org/2000/svg" aria-hidden="true" fill="currentColor" focusable="false" role="img" width="1em" height="1em" preserveAspectRatio="xMidYMid meet" viewBox="0 0 32 32"><path d="M28,10V28H10V10H28m0-2H10a2,2,0,0,0-2,2V28a2,2,0,0,0,2,2H28a2,2,0,0,0,2-2V10a2,2,0,0,0-2-2Z" transform="translate(0)"></path><path d="M4,18H2V4A2,2,0,0,1,4,2H18V4H4Z" transform="translate(0)"></path><rect fill="none" width="32" height="32"></rect></svg> <div class="absolute pointer-events-none transition-opacity bg-black text-white py-1 px-2 leading-tight rounded font-normal shadow left-1/2 top-full transform -translate-x-1/2 translate-y-2 opacity-0"><div class="absolute bottom-full left-1/2 transform -translate-x-1/2 w-0 h-0 border-black border-4 border-t-0" style="border-left-color: transparent; border-right-color: transparent; "></div> Copied</div></button></div> <pre class=""><!-- HTML_TAG_START --><span class="hljs-built_in">ls</span> <span class="hljs-variable">$CONDA_PREFIX</span>/lib/*cudart*<!-- HTML_TAG_END --></pre></div> <p data-svelte-h="svelte-1qer9s5">Make sure this path is appended to the <code>LD_LIBRARY_PATH</code> so bnb can find the CUDA runtime environment library (cudart).</p> <p data-svelte-h="svelte-1jgdees">If this does not fix the issue, please try compilation from source next.</p> <p data-svelte-h="svelte-vfybam">If this does not work, please open an issue and paste the printed environment if you call <code>make</code> and the associated error when running bnb.</p> <a class="!text-gray-400 !no-underline text-sm flex items-center not-prose mt-4" href="https://github.com/bitsandbytes-foundation/bitsandbytes/blob/main/docs/source/errors.mdx" target="_blank"><span data-svelte-h="svelte-1kd6by1">&lt;</span> <span data-svelte-h="svelte-x0xyl0">&gt;</span> <span data-svelte-h="svelte-1dajgef"><span class="underline ml-1.5">Update</span> on GitHub</span></a>  <p></p> 
			
			<script>
				{
					__sveltekit_8ajkxq = {
						assets: "/docs/bitsandbytes/pr_1349/en",
						base: "/docs/bitsandbytes/pr_1349/en",
						env: {}
					};

					const element = document.currentScript.parentElement;

					const data = [null,null];

					Promise.all([
						import("/docs/bitsandbytes/pr_1349/en/_app/immutable/entry/start.49de2a9e.js"),
						import("/docs/bitsandbytes/pr_1349/en/_app/immutable/entry/app.71938ec3.js")
					]).then(([kit, app]) => {
						kit.start(app, element, {
							node_ids: [0, 4],
							data,
							form: null,
							error: null
						});
					});
				}
			</script>