Create README.md

README.md

@@ -0,0 +1,56 @@
+---
+title: Homeostasis Explorer
+emoji: 🫀
+colorFrom: red
+colorTo: blue
+sdk: streamlit
+app_file: app.py
+pinned: false
+license: mit
+---
+
+# Homeostasis Explorer
+
+Interactive teaching app for visualizing how changes in **PaCO₂** affect **respiratory rate (RR)**, **pH**, and **cerebral blood flow (CBF)**. Designed for an online, asynchronous 300-level physiology course.
+
+> **Student link (share this):**  
+> `https://<owner>-<space-name>.hf.space`  
+> Replace `<owner>-<space-name>` with your actual Space URL (e.g., `rick-hes-homeostasis-explorer.hf.space`).
+
+---
+
+## How to use (students)
+1. Open the link above.
+2. Move the **PaCO₂** slider (20–80 mmHg).
+3. Observe real-time updates to RR, pH, and CBF plus trend graphs.
+4. Use the display to answer guided questions in your worksheet or quiz.
+
+---
+
+## Instructor notes
+- Coefficients are **illustrative** for teaching. Tweak them in `app.py` to match your model:
+  - RR: `RR = RR_base + 0.6 * (PaCO2 - 40)`
+  - pH: `pH = 7.40 - 0.01 * (PaCO2 - 40)`
+  - CBF (relative): `CBF = 1.0 * (1 + 0.015 * (PaCO2 - 40))`
+- Suggested activities:
+  - Have students capture screenshots at PaCO₂ = 30, 40, 50, 60 mmHg and explain trends.
+  - Ask them to predict values before moving the slider, then verify and reflect on any mismatch.
+
+---
+
+## Files in this Space
+- `app.py` — Streamlit app (main entry point).
+- `requirements.txt` — minimal Python deps.
+- `README.md` — this file.
+
+If you see **“Welcome to Streamlit”** instead of the app:
+- Ensure **Settings → SDK** is **Streamlit** and **App file** is exactly `app.py`.
+- Confirm `app.py` exists at the repo root (or update **App file** to the correct path).
+
+---
+
+## Run locally (optional)
+```bash
+python -m venv .venv && source .venv/bin/activate  # Windows: .venv\Scripts\activate
+pip install -r requirements.txt
+streamlit run app.py