Troubleshooting

Windows: bibexpy is not recognized

bibexpy : The term 'bibexpy' is not recognized as the name of a cmdlet...

Your Python Scripts folder isn't on PATH — common with Microsoft Store Python and pip install --user. Nothing is broken: python -m bibexpy always works.

Fix it permanently (pick one):

1. Easiest — start the app once with python -m bibexpy: it detects the situation and offers to add itself to PATH. Answer Y, open a NEW terminal, done. (You can also force it with python -m bibexpy --add-path.)
2. Manual — the startup banner prints a personalized copy-paste PowerShell command with your exact Scripts folder.
3. Or install via pipx (pipx install bibexpy) — pipx manages PATH for you.

macOS / Linux: python or pip not found

Use python3 / pip3. If pip is missing entirely:

python3 -m ensurepip --upgrade        # most systems
sudo apt install python3-pip          # Debian / Ubuntu

Port already in use

BibexPy automatically tries the next free port (6060 → 6061 → …). To pin one:

python -m bibexpy --port 8080

The browser doesn't open

Start with --no-browser and open the printed URL manually. On remote/headless machines, forward the port (e.g. ssh -L 6060:127.0.0.1:6060 user@host) and browse locally.

Upgrade didn't take effect

pip may have updated a different Python's site-packages. Verify with:

python -m bibexpy --version

If the version is stale, reinstall explicitly against the interpreter you launch with:

python -m pip install -U --force-reinstall --no-deps bibexpy

Enrichment returns nothing

• Check your API keys on the Settings page (Crossref/OpenAlex/Unpaywall are free and keyless; only Scopus needs a key).
• Corporate proxies/firewalls can block outbound HTTPS — enrichment providers must be reachable from your machine.

Where are my projects on disk?

~/.bibexpy/storage (or the folder you passed via --storage). Each project is a plain directory — safe to back up or move between machines.