PrazNeuro/Brain_Cancer_Trails_Finder

Brain Cancer Trials Finder

Desktop Application, Streamlit app and code

Brain Cancer Trails Finder (Desktop Application)

The link for download is here: (Coming soon)

This application uses API with Clinical Trials Registry at NIH (ClinicalTrails.gov, USA) and provides scores according to the type of brain cancer input on the GUI. It also provides links directly to UK cancer registers and search is performed automatically on the type of cancer selected (CRUK, NIHR, ISRCTN(UK) )

Brain Cancer Trials Finder (Streamlit)

A minimal Streamlit app that discovers actively recruiting neuro-oncology clinical trials (e.g., glioblastoma, brain tumors) from the ClinicalTrials.gov v2 API and ranks them with simple, explainable heuristics.

Demo features:

• Filters by country and basic patient factors (age, KPS, setting).
• Pulls live data from ClinicalTrials.gov v2.
• Scores trials with transparent reasons for the score.

Local run

Prereqs: Python 3.9+.

python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
streamlit run streamlit_app.py

Deploy to Streamlit Community Cloud

1. Push this folder to a new GitHub repository (see steps below).
2. Go to https://share.streamlit.io/ and connect your GitHub account.
3. Create a new app, select your repo, branch (e.g., main), and set the main file path to streamlit_app.py.
4. Click Deploy. Streamlit will build from requirements.txt automatically.

GitHub repository setup (Windows, cmd.exe)

1. Create an empty repo on GitHub (e.g., brain-trials-finder). Do not add any files there.
2. In this project folder, run:

git init
git add .
git commit -m "Initial commit: Streamlit Brain Cancer Trials Finder"
git branch -M main
REM Replace <YOUR-USERNAME> and repo name below
git remote add origin https://github.com/<YOUR-USERNAME>/brain-trials-finder.git
git push -u origin main

If you prefer SSH:

git remote remove origin 2> NUL
git remote add origin [email protected]:<YOUR-USERNAME>/brain-trials-finder.git
git push -u origin main

Configuration

• No secrets are required. All data is pulled from the public ClinicalTrials.gov API.
• If you want to pin Python version on Streamlit Cloud, add a runtime.txt (e.g., python-3.10), though it’s optional.

Files

• streamlit_app.py — Streamlit entrypoint used by Streamlit Cloud.
• GUI_CLinicalTrial.py — Original app file; kept for development, but streamlit_app.py mirrors it for deployment.
• requirements.txt — Python dependencies.
• .gitignore — Ignores typical Python/venv artifacts.

Disclaimer

This tool provides assistive information only and is not a substitute for professional medical advice. Always discuss clinical trials with your clinician.

Copyright: Prajwal Ghimire