NeuroAIHub
Find public neuroradiology datasets by chatting with the NeuroAI Chat Agent — the same agent that powers the NeuroAIHub website — over a curated database of 368 datasets in seven categories (Neurodegenerative, Neoplasm, Cerebrovascular, Psychiatric, Spinal, Neurodevelopmental, Other).
Paper: AJNR, ajnr.A9363 · Code: GitHub
Install
pip install neuroaihub
Chat with the database
from neuroaihub import NeuroAIChatAgent
agent = NeuroAIChatAgent(
api_key="YOUR_API_KEY",
base_url="https://openrouter.ai/api/v1", # leave out for OpenAI
model="nvidia/nemotron-3-super-120b-a12b:free", # e.g. "gpt-5" with OpenAI
)
result = agent.chat("Which open-access glioma MRI datasets have segmentation masks?")
agent.display(result) # answer, result table and charts (rich output in Jupyter)
result = agent.chat("Which of those were published since 2023?") # follow-ups use the previous results
result["data"] # matching datasets as a pandas DataFrame
Any OpenAI-compatible provider works if the model supports tool (function) calling. Every dataset name, number and link in an answer is computed from the database by the agent's tools — the model does not answer from memory.
chat() returns a dict: text, data (DataFrame or None), image_b64 / images (charts as base64 PNG),
steps (database lookups made), status, error, model_calls. Use agent.reset() to start a new conversation and
verbose=True to print the lookups.
Always the latest database
The package reads the database straight from the NeuroAIHub GitHub repository,
so new and corrected datasets are available as soon as they are published there — no package update needed.
The download is cached for 24 hours (in ~/.cache/neuroaihub); without internet the cached copy, or the copy bundled
with the package, is used. NeuroAIChatAgent(..., refresh_data=True) or load_database(refresh=True) forces a fresh
download; agent.data_source shows where the data came from.
Use the database directly
from neuroaihub import load_database
dataframes, combined_df, categories = load_database() # latest from GitHub: one DataFrame per category + all combined
Each dataset has 22 metadata fields: name, DOI, URL, year, access type, institution, country, modality, resolution, number of subjects and scans, age range, acquisition protocol, image format, segmentation masks, preprocessing, disease, healthy controls, staging, clinical data, histopathology and lab data.
Changes in 2.0
- New chat agent (identical to the website): tool calling instead of LangChain, about 2 model calls per question, charts (bar, pie, line, multi-series, scatter, histogram, box), follow-up questions, and robust handling of free and smaller models.
- Updated and cleaned database (368 datasets, seven categories), read live from GitHub.
- The dataset updating agent (
NeuroAIUpdater) has been removed.
License: CC BY-NC-ND 4.0.
Metadata
Release files for neuroaihub 1.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| neuroaihub-1.1.0.tar.gz | 104.6 kB | Without provenance | Details for neuroaihub-1.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| neuroaihub-1.1.0-py3-none-any.whl | Python 3 | none | any | Details for neuroaihub-1.1.0-py3-none-any.whl |
Total release size: 216.3 kB
Release files / neuroaihub-1.1.0.tar.gz
| Download URL | neuroaihub-1.1.0.tar.gz |
|---|---|
| Size | 104.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ac8d7b277d557d7d4a8fb91e58c5faffdd65a3bc5fe1aac1c3d720629caa2b87
|
|
BLAKE2b-256 checksum How to use checksums |
d4e6cbd0089ae5c7c15bee7151e7b9212ab1ea6f51fa3acf9d5c0d7aa4bed7ae
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.2
|
Release files / neuroaihub-1.1.0-py3-none-any.whl
| Download URL | neuroaihub-1.1.0-py3-none-any.whl |
|---|---|
| Size | 111.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
0335a34553371669a3e25bcf5a66c726d928989ae3ee3b15f7b601924ddaca99
|
|
BLAKE2b-256 checksum How to use checksums |
6c8c27b5a93a344a50664f52dfe41e7788ab74472061ba67813733d7f8b5396d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.10.2
|
Security for neuroaihub 1.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.