Skip to main content

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)

Source distribution for neuroaihub 1.1.0
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)

Table of built distributions (wheels) for neuroaihub 1.1.0
File Interpreter ABI Platform Actions
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.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page