radlab‑playground‑ui is a Streamlit‑based interactive playground that lets users explore information, browse generated summaries, interact with generative chat models, and monitor system status.
The interface is fully localisation‑aware, supporting multiple languages out‑of‑the‑box, and is publicly available at https://playground.radlab.dev.
All interactions are performed through a set of thin wrapper APIs (src/api_public.py)
that communicate with the backend services. The interface is fully configurable
via JSON and Excel files, making it easy to adapt to new languages, logos, or data sources.
The streamlit_ui/pages/ directory contains the individual Streamlit pages that make up the UI. Below is a short
description of each page:
| File | Description |
|---|---|
administration.py |
Administrative tools for system settings, and monitoring backend health. |
creator_actual.py |
Interface for creating article from indexed summaries based on the user query (RAG) |
home.py |
The landing page that introduces the playground, provides quick links to all other sections, and displays general information. |
info_explorator.py |
Explores informational graphs, showing examples, explanations, and how the explorer works. |
news_browser.py |
Browse generated items, filter by topics or dates, and view full articles. |
news_stream.py |
Real‑time news indexing mechanism, showing the latest generated headlines and summaries. |
public_chat.py |
Public chat interface that connects to the generative chat model for interactive conversations. |
statistics.py |
Displays statistics, metrics. |
The UI is deployed and can be accessed publicly at:
Visit the URL above to explore the playground without any local setup.
-
Prerequisites
- Python >= 3.9
git(to clone the repo)
-
Clone the repository
git clone https://github.com/your-org/radlab-playground-ui.git
cd radlab-playground-ui- Create a virtual environment (optional but recommended)
python -m venv .venv
source .venv/bin/activate\- Install dependencies
pip install --upgrade pip
pip install -r requirements.txt-
Verify the resources
resources/configs/ui-configuration.json– UI defaults.resources/language/ui_lang_def.xlsx– translation strings.resources/images/– logos and graphics used throughout the UI.
If you need to customise any of these files, edit them directly; the UI reads them at start‑up.
The repository ships a tiny wrapper script that launches Streamlit with the correct entry point:
./run.shrun.sh simply executes:
streamlit run streamlit_ui/app.pyYou can also start the app manually:
streamlit run streamlit_ui/app.py