Overview

Resolve common issues and errors when using Xorq

Use this section when installation, connections, or execution fail. Each page covers one area so you can jump to the right fix.

Troubleshooting

Use the cards below to find fixes for installation, connections, errors, or performance.

Installation issues

“No matching distribution found,” ModuleNotFoundError, or missing backend (for example, DuckDB)

Backend connection issues

Connection timeouts, auth errors, or file or path not found (for example, S3)

Common errors

Schema mismatch, CSV parsing errors, out-of-memory, or evaluation and metrics issues

Performance problems

Queries slow or hanging, or evaluation too slow

Pipeline failures

Pipeline execution errors, missing columns, or wrong step configuration

Caching issues

Cache misses, stale results, or storage errors

Still having issues?

Check GitHub issues or join the Discord community for support.