check-hallucinations
A command-line tool to detect hallucinated references in BibTeX files before submitting a paper to arXiv.
It checks each reference against Semantic Scholar and flags any title that cannot be found.
Installation
pip install check-hallucinations
Usage
check-hallucinations references.bib
Entries that cannot be found on Semantic Scholar are printed in red as potential hallucinations.
How it works
For each entry in the BibTeX file, the tool queries Semantic Scholar by title. If no match is found, the entry is flagged as a likely hallucination (a reference invented by an LLM or a typo). misc entries without an eprint field are skipped unless they lack a howpublished URL.
API key
By default the tool uses the public Semantic Scholar API (rate-limited). For higher throughput, set the SEMANTICSCHOLAR_API_KEY environment variable:
export SEMANTICSCHOLAR_API_KEY=your-key-here
check-hallucinations references.bib
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file check_hallucinations-0.16.0-py3-none-any.whl.
File metadata
- Download URL: check_hallucinations-0.16.0-py3-none-any.whl
- Upload date:
- Size: 7.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
59f3df86308b46fc2e096a5699e1b6c9ad0175974d8f3e05ec7a0f68d2f61543
|
|
| MD5 |
b66878a6cd29340882f4af3df2f2db1a
|
|
| BLAKE2b-256 |
25e17f024c44bb43437a31bc3a0e861c01ff75748386d56e44d2df1c365decd6
|
Provenance
The following attestation bundles were made for check_hallucinations-0.16.0-py3-none-any.whl:
Publisher:
pypi-publish.yml on ASSERT-KTH/check-hallucinations
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
check_hallucinations-0.16.0-py3-none-any.whl -
Subject digest:
59f3df86308b46fc2e096a5699e1b6c9ad0175974d8f3e05ec7a0f68d2f61543 - Sigstore transparency entry: 2163720895
- Sigstore integration time:
-
Permalink:
ASSERT-KTH/check-hallucinations@438ce0c33f9a817bc97651429c161d96fe949760 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/ASSERT-KTH
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pypi-publish.yml@438ce0c33f9a817bc97651429c161d96fe949760 -
Trigger Event:
push
-
Statement type:
