[BUG] no such module: fts5

[jonduenas]

Bug Description

When trying to write a note with basic-memory in Claude Code, I always get an error about "no such module: fts5".

I installed basic-memory initially through homebrew, but I just now tried uninstalling and then reinstalling using the "single step installation" using curl. I've restarted terminal and Claude Code and nothing seems to fix this.

Steps To Reproduce

Steps to reproduce the behavior:

1. Install version 0.14.2 (I used "single step installation")
2. Add MCP to Claude Code
3. Ask Claude Code to write a note
4. See error

Expected Behavior

The note is written.

Actual Behavior

Error: Error calling tool 'write_note': (sqlite3.OperationalError) no such module: fts5
     [SQL:
                 SELECT
                     project_id,
                     id,
                     title,
                     permalink,
                     file_path,
                     type,
                     metadata,
                     from_id,
                     to_id,
                     relation_type,
                     entity_id,
                     content_snippet,
                     category,
                     created_at,
                     updated_at,
                     bm25(search_index) as score
                 FROM search_index
                 WHERE (title MATCH ? OR content_stems MATCH ?) AND type IN ('entity') AND project_id = ?
                 ORDER BY score ASC
                 LIMIT ?
                 OFFSET ?
             ]
     [parameters: ('"test/Basic Memory Test.md"', '"test/Basic Memory Test.md"', 1, 10, 0)]
     (Background on this error at: https://sqlalche.me/e/20/e3q8)

Environment

• OS: macOS 15.5
• Python version: 3.13.5
• Basic Memory version: 0.14.2
• Installation method: uv via "single step installation" script
• Claude Desktop version (if applicable): n/a (Using Claude Code 1.0.65)

Additional Context

Possible Solution

[phernandez]

This sounds like the same issue as #221

@jonduenas check your uv version. Uv had a bad version where the python lib it installed did not contain all of the sqlite libs (especially fts5). See that issue for detail. But this may solve your problem

#221 (comment)

[jonduenas]

This sounds like the same issue as #221

@jonduenas check your uv version. Uv had a bad version where the python lib it installed did not contain all of the sqlite libs (especially fts5). See that issue for detail. But this may solve your problem

#221 (comment)

Thanks, I did see that issue. But, I'm on uv 0.8.4.

I initially installed with homebrew, and then later tried the "single step" script on the website. Both installed uv for me as I didn't have it before.

I tried these exact steps on my personal Mac just now. Used the script to install and then tested with Claude Code, and it worked perfectly fine. So, it does seem like maybe something specific with my setup on my work Mac. I'm fine with closing this and reaching out maybe on Discord or something instead of that's preferable.

[phernandez]

We are more than happy to help on discord. One thing that I saw was that even upgrading up didn't help you had to tell uv to reinstall the default python version also. It was a PITA unfortunately. If you post on our help channel on discord we can work it out.

[jonduenas]

After a series of uninstalling and reinstalling I finally managed to get this working on my work machine. Thank you for the help @phernandez

[phernandez]

@jonduenas no problem. That was an unfortunate issue. Glad you got it worked out.