# Failed installation

**URL:** <https://forums.ankiweb.net/t/failed-installation/68494>\
**Category:** Help\
**Created:** [January 28, 2026, 2:05am UTC](https://forums.ankiweb.net/t/failed-installation/68494 "2026-01-28T02:05:37Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![Anding](https://avatars.discourse-cdn.com/v4/letter/a/74df32/32.png) [@Anding](https://forums.ankiweb.net/u/Anding)\
**Post date:** [January 28, 2026, 2:05am UTC](https://forums.ankiweb.net/t/failed-installation/68494/1 "2026-01-28T02:05:37Z")

</div>

Hello, I get the following error when installing ANKI

> Anki Launcher
> 
> 1. Latest Anki (press Enter)
> 
> 2. Choose a version
> 
> 3. Allow betas: off
> 
> 4. Cache downloads: on
> 
> 5. Download mirror: off
> 
> 6. Uninstall
> 
> > 1
> 
> Checking for updates…  
> Unable to check for Anki versions. Please check your internet connection.
> 
> Error: Failed to run (2): C:\Users\Andrew\AppData\Local\Programs\Anki\uv.exe run --no-project --no-config --managed-python --with pip-system-certs,requests[socks] --python 3.13.5 C:\Users\Andrew\AppData\Local\Programs\Anki\versions.py: error: Querying Python at `C:\Users\Andrew\AppData\Roaming\uv\python\cpython-3.13.5-windows-x86_64-none\python.exe` failed with exit status exit code: 1
> 
> [stderr]  
> Fatal Python error: Failed to import encodings module  
> Python runtime state: core initialized  
> File “”, line 0  
> SyntaxError: source code string cannot contain null bytes
> 
> Current thread 0x0000626c (most recent call first):
> 
> Press enter to close…

Here is my Windows: spec

Edition Windows 11 Home  
Version 25H2  
Installed on ‎30/‎12/‎2025  
OS build 26200.7623  
Experience Windows Feature Experience Pack 1000.26100.275.0

My computer is connected to the internet for sure, that’s how I posted this message!

---

<div class="post-metadata">

**Author:** ![Danika\_Dakika](https://sea2.discourse-cdn.com/flex002/user_avatar/forums.ankiweb.net/danika_dakika/32/17815_2.png) [@Danika\_Dakika](https://forums.ankiweb.net/u/Danika_Dakika)\
**Post date:** [January 28, 2026, 4:50am UTC](https://forums.ankiweb.net/t/failed-installation/68494/2 "2026-01-28T04:50:53Z")

</div>

You should search for recent posts with similar launcher errors, and try everything in those threads.

[https://forums.ankiweb.net/search?q=Error%3A+Failed+to+run](https://forums.ankiweb.net/search?q=Error%3A+Failed+to+run)

---

<div class="post-metadata">

**Author:** ![Anding](https://avatars.discourse-cdn.com/v4/letter/a/74df32/32.png) [@Anding](https://forums.ankiweb.net/u/Anding)\
**Post date:** [January 28, 2026, 6:48am UTC](https://forums.ankiweb.net/t/failed-installation/68494/3 "2026-01-28T06:48:10Z")

</div>

That thread has no solutions! This is a complicated installer because it runs a script, so it will be hard to diagnose the underlying problem

---

<div class="post-metadata">

**Author:** ![Danika\_Dakika](https://sea2.discourse-cdn.com/flex002/user_avatar/forums.ankiweb.net/danika_dakika/32/17815_2.png) [@Danika\_Dakika](https://forums.ankiweb.net/u/Danika_Dakika)\
**Post date:** [January 28, 2026, 8:00am UTC](https://forums.ankiweb.net/t/failed-installation/68494/4 "2026-01-28T08:00:12Z")

</div>

There are many threads with many solutions offered. You should try them all.

---

<div class="post-metadata">

**Author:** ![Anding](https://avatars.discourse-cdn.com/v4/letter/a/74df32/32.png) [@Anding](https://forums.ankiweb.net/u/Anding)\
**Post date:** [January 28, 2026, 11:39am UTC](https://forums.ankiweb.net/t/failed-installation/68494/5 "2026-01-28T11:39:18Z")

</div>

Here is the solution. Avoid broken installer and revert to an earlier release:

[https://github.com/ankitects/anki/releases/tag/25.02.7](https://github.com/ankitects/anki/releases/tag/25.02.7)

This is software for language learner. You shouldn’t need a PhD in windows security to install it. Being “free” is no excuse and actually illustrates the problem with free software. If we were paying for it (I would be happy to) then we’d have a right to a functional installer, and the author would have a financial incentive to make the installer work for everybody.

---

<div class="post-metadata">

**Author:** ![Anon\_0000](https://avatars.discourse-cdn.com/v4/letter/a/c67d28/32.png) [@Anon\_0000](https://forums.ankiweb.net/u/Anon_0000)\
**Post date:** [January 28, 2026, 11:53am UTC](https://forums.ankiweb.net/t/failed-installation/68494/6 "2026-01-28T11:53:33Z")

</div>

You should know it works fine for most people. Your issue can only be solved if affected people like you give proper steps to reproduce and do proper debugging / testing.

> [@Anding](#):
>
> You shouldn’t need a PhD in windows security to install it. Being “free” is no excuse and actually illustrates the problem with free software.

You don’t, obviously. Paid software would have the same issue if noone can find the underlying issue that makes the launcher error out in a fraction of users.

> [@Anding](#):
>
> Here is the solution. Avoid broken installer and revert to an earlier release:

That’s not a solution, that’s a workaround. Good you got it working but there obviously won’t be any way for devs to fix the issue if the underlying issue in your machine is unknown. It could be everything, including that not Anki is at fault but the users setup instead.

---

<div class="post-metadata">

**Author:** ![Anon\_0000](https://avatars.discourse-cdn.com/v4/letter/a/c67d28/32.png) [@Anon\_0000](https://forums.ankiweb.net/u/Anon_0000)\
**Post date:** [January 28, 2026, 11:58am UTC](https://forums.ankiweb.net/t/failed-installation/68494/7 "2026-01-28T11:58:09Z")

</div>

Also, maybe your python installation is at fault. You could try if python works fine if called via command line or remove and reinstall python if you really wish to help debug this.

---

<div class="post-metadata">

**Author:** ![abdo](https://sea2.discourse-cdn.com/flex002/user_avatar/forums.ankiweb.net/abdo/32/654_2.png) [@abdo](https://forums.ankiweb.net/u/abdo)\
**Post date:** [January 28, 2026, 12:05pm UTC](https://forums.ankiweb.net/t/failed-installation/68494/8 "2026-01-28T12:05:47Z")

</div>

I found a possible cause of the issue. Try this:

1. Go to the **Environment Variables** screen under **System Properties** ([Google](https://www.google.com/search?q=Windows+11+Environment+Variables)).
2. Search for a variable named `PYTHONHOME` under **User variables** and **System variables**. Delete the variable or rename it to something else temporarily.  
 ![image](https://us1.discourse-cdn.com/flex002/uploads/anki2/original/3X/b/a/ba8ad2886bb83b8001e9386a04ec8e6e18195c52.png)
3. Run the installer again.

Tracked here: [Installer fails if invalid PYTHONHOME is set? · Issue #4523 · ankitects/anki · GitHub](https://github.com/ankitects/anki/issues/4523)

---

<div class="post-metadata">

**Author:** ![Anding](https://avatars.discourse-cdn.com/v4/letter/a/74df32/32.png) [@Anding](https://forums.ankiweb.net/u/Anding)\
**Post date:** [January 28, 2026, 12:16pm UTC](https://forums.ankiweb.net/t/failed-installation/68494/9 "2026-01-28T12:16:58Z")

</div>

Hello, I typed “python” at the command prompt and it took me to the windows store to download it. If a dev can give me a script to run on my machine that will generate useful error messages, I’ll take a look.

I don’t particularly want Python installed on my machine anyway.

---

<div class="post-metadata">

**Author:** ![abdo](https://sea2.discourse-cdn.com/flex002/user_avatar/forums.ankiweb.net/abdo/32/654_2.png) [@abdo](https://forums.ankiweb.net/u/abdo)\
**Post date:** [January 28, 2026, 12:21pm UTC](https://forums.ankiweb.net/t/failed-installation/68494/10 "2026-01-28T12:21:01Z")

</div>

You don’t need to have Python installed. See my comment above.

---

<div class="post-metadata">

**Author:** ![Anding](https://avatars.discourse-cdn.com/v4/letter/a/74df32/32.png) [@Anding](https://forums.ankiweb.net/u/Anding)\
**Post date:** [January 28, 2026, 1:00pm UTC](https://forums.ankiweb.net/t/failed-installation/68494/11 "2026-01-28T13:00:04Z")

</div>

On my system there is no PYTHONHOME or other PYTHON environment variable

---

<div class="post-metadata">

**Author:** ![abdo](https://sea2.discourse-cdn.com/flex002/user_avatar/forums.ankiweb.net/abdo/32/654_2.png) [@abdo](https://forums.ankiweb.net/u/abdo)\
**Post date:** [January 28, 2026, 2:09pm UTC](https://forums.ankiweb.net/t/failed-installation/68494/12 "2026-01-28T14:09:22Z")

</div>

Do you have this folder?  
`C:\Users\Andrew\AppData\Roaming\uv\python\cpython-3.13.5-windows-x86_64-none`

What do you see if you run the `python.exe` executable inside? If you see some errors, delete the whole folder and rerun the installer.

---

<div class="post-metadata">

**Author:** ![Anding](https://avatars.discourse-cdn.com/v4/letter/a/74df32/32.png) [@Anding](https://forums.ankiweb.net/u/Anding)\
**Post date:** [January 28, 2026, 10:39pm UTC](https://forums.ankiweb.net/t/failed-installation/68494/13 "2026-01-28T22:39:54Z")

</div>

The folder is there. When I run python.exe nothing happens in the terminal window and no errors are reported but the Microsoft store app opens offering me the opportunity to download Python.

 ![Screenshot 2026-01-29 063737](https://us1.discourse-cdn.com/flex002/uploads/anki2/original/3X/8/6/869e766266d2bf63dca4101fd4e6366b554f533c.png)

---

<div class="post-metadata">

**Author:** ![Anding](https://avatars.discourse-cdn.com/v4/letter/a/74df32/32.png) [@Anding](https://forums.ankiweb.net/u/Anding)\
**Post date:** [January 28, 2026, 10:42pm UTC](https://forums.ankiweb.net/t/failed-installation/68494/14 "2026-01-28T22:42:21Z")

</div>

I deleted that folder, re-downloaded ANKI, but the installer still fails

Anki Launcher

1. Latest Anki (press Enter)

2. Choose a version

3. Allow betas: off

4. Cache downloads: on

5. Download mirror: off

6. Uninstall

> 1

Checking for updates…  
Unable to check for Anki versions. Please check your internet connection.

Error: Failed to run (1): C:\Users\Andrew\AppData\Local\Programs\Anki\uv.exe run --no-project --no-config --managed-python --with pip-system-certs,requests[socks] --python 3.13.5 C:\Users\Andrew\AppData\Local\Programs\Anki\versions.py: Downloading cpython-3.13.5-windows-x86\_64-none (download) (20.1MiB)  
Downloading cpython-3.13.5-windows-x86\_64-none (download)  
Error processing line 1 of C:\Users\Andrew\AppData\Local\uv\cache\archive-v0\5y1\_YRgTLo8mdgEkcUwNU\Lib\site-packages\_virtualenv.pth:

Traceback (most recent call last):  
File “”, line 207, in addpackage  
File “”, line 1, in  
SyntaxError: source code string cannot contain null bytes

Remainder of file ignored  
Error processing line 1 of C:\Users\Andrew\AppData\Local\uv\cache\archive-v0\5y1\_YRgTLo8mdgEkcUwNU\Lib\site-packages\pip\_system\_certs.pth:

Traceback (most recent call last):  
File “”, line 207, in addpackage  
File “”, line 1, in  
SyntaxError: source code string cannot contain null bytes

Remainder of file ignored  
Error processing line 1 of C:\Users\Andrew\AppData\Local\uv\cache\archive-v0\5y1\_YRgTLo8mdgEkcUwNU\Lib\site-packages\_virtualenv.pth:

Traceback (most recent call last):  
File “”, line 207, in addpackage  
File “”, line 1, in  
SyntaxError: source code string cannot contain null bytes

Remainder of file ignored  
Error processing line 1 of C:\Users\Andrew\AppData\Local\uv\cache\archive-v0\5y1\_YRgTLo8mdgEkcUwNU\Lib\site-packages\pip\_system\_certs.pth:

Traceback (most recent call last):  
File “”, line 207, in addpackage  
File “”, line 1, in  
SyntaxError: source code string cannot contain null bytes

Remainder of file ignored  
Traceback (most recent call last):  
File “C:\Users\Andrew\AppData\Local\Programs\Anki\versions.py”, line 7, in  
import pip\_system\_certs.wrapt\_requests  
SyntaxError: source code string cannot contain null bytes

Press enter to close…

---

<div class="post-metadata">

**Author:** ![BenJamesBen](https://avatars.discourse-cdn.com/v4/letter/b/13edae/32.png) [@BenJamesBen](https://forums.ankiweb.net/u/BenJamesBen)\
**Post date:** [January 29, 2026, 2:13am UTC](https://forums.ankiweb.net/t/failed-installation/68494/15 "2026-01-29T02:13:57Z")

</div>

I’m not familiar with Windows, Python, or uv, but would deleting the uv cache be something useful to try? On the OP’s system the cache appears to be `C:\Users\Andrew\AppData\Local\uv\cache`.

(From the most recent set of error messages, it seems that python might be having trouble processing two cache files, perhaps finding them to be null files or to have null characters in them.)

---

<div class="post-metadata">

**Author:** ![Shigeyuki](https://sea2.discourse-cdn.com/flex002/user_avatar/forums.ankiweb.net/shigeyuki/32/23878_2.png) [@Shigeyuki](https://forums.ankiweb.net/u/Shigeyuki)\
**Post date:** [January 29, 2026, 10:44am UTC](https://forums.ankiweb.net/t/failed-installation/68494/16 "2026-01-29T10:44:09Z")

</div>

Isn’t the path where Anki’s uv cache files are saved `C:\Users\username\AppData\Local\AnkiProgramFiles`? `C:\Users\username\AppData\Local\uv\cache` seems to be the cache for uv installed on the PC, I think Anki probably doesn’t use it. (but I didn’t develop the launcher, so I don’t know exactly.)

Is the launcher you’re using the latest version? The old launcher had some bugs and I think the new launcher has fixed them. The launcher probably won’t update itself so users of the old launcher will need to download it manually.

---

<div class="post-metadata">

**Author:** ![BenJamesBen](https://avatars.discourse-cdn.com/v4/letter/b/13edae/32.png) [@BenJamesBen](https://forums.ankiweb.net/u/BenJamesBen)\
**Post date:** [January 29, 2026, 3:09pm UTC](https://forums.ankiweb.net/t/failed-installation/68494/17 "2026-01-29T15:09:16Z")

</div>

> [@Shigeyuki](#):
>
> Isn’t the path where Anki’s uv cache files are saved `C:\Users\username\AppData\Local\AnkiProgramFiles`?

On my Mac, I saw that there were two cache directories containing uv cache files:

1. `~/Library/Application Support/AnkiProgramFiles/cache`
2. `~/.cache/uv`

Cache 1 contained directories created up through September 2025, while Cache 2 contained directories created in October and December 2025. So, it looks as if Anki might have switched cache locations sometime around September/October 2025.

I then deleted both cache directories, ran Anki, and selected Tools → Upgrade/Downgrade to get the Anki Launcher terminal menu. I selected option “#3 Keep existing version (25.09.2)” to exit. At that point, I observed that the Cache 2 directory was re-created while the Cache 1 directory was not.

So, on Mac it appears that the Anki Launcher (25.09) no longer uses the `AnkiProgramFiles` directory for its cache location. I imagine that the situation might be similar on Windows systems?

---

<div class="post-metadata">

**Author:** ![abdo](https://sea2.discourse-cdn.com/flex002/user_avatar/forums.ankiweb.net/abdo/32/654_2.png) [@abdo](https://forums.ankiweb.net/u/abdo)\
**Post date:** [February 2, 2026, 8:23am UTC](https://forums.ankiweb.net/t/failed-installation/68494/18 "2026-02-02T08:23:33Z")

</div>

@Anding To confirm if it’s a caching issue, you can disable and clear the cache by pressing 6 when running the launcher.

 ![image](https://us1.discourse-cdn.com/flex002/uploads/anki2/original/3X/7/7/77a3c37d2f44a11de5e8525ea3a9f9e0fa1a3a8c.png)

---

<div class="post-metadata">

**Author:** ![abdo](https://sea2.discourse-cdn.com/flex002/user_avatar/forums.ankiweb.net/abdo/32/654_2.png) [@abdo](https://forums.ankiweb.net/u/abdo)\
**Post date:** [February 2, 2026, 8:34am UTC](https://forums.ankiweb.net/t/failed-installation/68494/19 "2026-02-02T08:34:35Z")

</div>

> [@BenJamesBen](#):
>
> So, on Mac it appears that the Anki Launcher (25.09) no longer uses the `AnkiProgramFiles` directory for its cache location. I imagine that the situation might be similar on Windows systems?

This is fixed in [fix(launcher): apply cache settings to all uv invocations by iamllama · Pull Request #4404 · ankitects/anki · GitHub](https://github.com/ankitects/anki/pull/4404)

No launcher release includes the fix though yet.

---

<div class="post-metadata">

**Author:** ![system](https://us1.discourse-cdn.com/flex002/uploads/anki2/original/1X/8f1279ababc5879d54e4838989f606cfe55af8c7.jpeg) [@system](https://forums.ankiweb.net/u/system)\
**Post date:** [March 4, 2026, 8:35am UTC](https://forums.ankiweb.net/t/failed-installation/68494/20 "2026-03-04T08:35:16Z")

</div>

Closed on March 4, 2026, 8:35am UTC

This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.
