Support

Questions, bugs, and anything that isn't behaving.

Requirements

• macOS 14 Sonoma or later.
• An Apple Silicon Mac (M1 or newer). The local model runs on Apple's MLX framework, which does not support Intel Macs.
• About 1.74 GB of free space if you want to ask questions. The rest of the app needs almost nothing.

The model download failed

Open Settings ▸ Local Model. The status row shows what went wrong, and Retry starts the download again from scratch. Most failures are an interrupted connection or not enough free disk space.

Cancelling a download is not an error — EasyDB distinguishes the two, and you can restart whenever you like. Nothing else in the app is affected in the meantime.

I want the disk space back

Settings ▸ Local Model ▸ Remove Model… deletes the downloaded model. Your databases and your query history stay exactly as they were, and you can download the model again later if you change your mind.

A query returned an error

EasyDB rewrites SQLite's error messages into plain English along with a suggested fix, and keeps the original message under the Technical details disclosure. The most common causes:

• A table or column doesn't exist. Check the name against the sidebar — the model can only use what's in your schema, but it can still misread an ambiguous question.
• The database is locked. Another program is writing to the file. Close it and try again.
• The file is read-only. Check the file's permissions in Finder.

The query came back wrong

Select the relevant table in the sidebar before asking — EasyDB weights the selected table's schema most heavily when building the model's context. Naming tables or columns directly in your question helps too. And because the query lands in the editor rather than a chat window, you can always fix it by hand and run it.

Very large schemas are truncated to fit the model's context, so on a database with hundreds of tables, being specific matters more.

EasyDB asked me to confirm a query I didn't expect

That prompt appears whenever a statement would modify the database. EasyDB determines this by asking SQLite whether each statement is read-only, not by looking for particular keywords, so some statements that don't obviously look like writes will still ask. Choosing Cancel runs nothing at all.

Can I use EasyDB without the model?

Yes. Decline the model download and EasyDB is a straightforward SQLite client — schema browsing, a highlighted SQL editor with autocomplete, Explore mode, CSV export, query history, and recent databases all work with no model installed.

Refunds

Purchases go through the Mac App Store, so refunds are handled by Apple at reportaproblem.apple.com. If something isn't working, though, please email first — it's usually fixable.