Nursing Citizen Development commited on
Commit
cda84d7
·
1 Parent(s): e6e6e5d

docs: Add System Card and link in README

Browse files
Files changed (2) hide show
  1. README.md +3 -0
  2. SYSTEM_CARD.md +74 -0
README.md CHANGED
@@ -175,6 +175,9 @@ If you use this tool or model in your research, please cite:
175
  }
176
  ```
177
 
 
 
 
178
  ---
179
 
180
  ## 👤 Author
 
175
  }
176
  ```
177
 
178
+ ## 📜 System Card & Methodology
179
+ For a detailed technical breakdown of the system architecture, RAG implementation, and ethical considerations, please see the [**System Card**](SYSTEM_CARD.md).
180
+
181
  ---
182
 
183
  ## 👤 Author
SYSTEM_CARD.md ADDED
@@ -0,0 +1,74 @@
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
+ ---
2
+ title: "Building the PNA Assistant: A Nurse's Guide to AI Resilience Tools"
3
+ authors:
4
+ - user: NurseCitizenDeveloper
5
+ guest: true
6
+ tags:
7
+ - nlp
8
+ - healthcare
9
+ - gemma
10
+ - rag
11
+ - ethical-ai
12
+ - system-card
13
+ ---
14
+
15
+ # Building the PNA Assistant: A Nurse's Guide to AI Resilience Tools
16
+
17
+ **"AI isn't here to replace nurses. It's here to be built by us."**
18
+
19
+ The resilience of the nursing workforce is a global priority. In the UK, the **Professional Nurse Advocate (PNA)** role has been a game-changer, using the **A-EQUIP model** to provide restorative clinical supervision. But with staffing pressures, accessing a trained PNA when you need one most can be a challenge.
20
+
21
+ What if we could build a tool to bridge that gap? Not to replace the human supervisor, but to provide a safe, 24/7 space for reflection?
22
+
23
+ Enter the **PNA Assistant**—an open-source AI research tool built by a nurse, for nurses.
24
+
25
+ ## 🏥 What is the PNA Assistant?
26
+
27
+ The [PNA Assistant](https://huggingface.co/spaces/NurseCitizenDeveloper/PNA-Assistant) is a specialized AI agent designed to simulate the "Restorative Clinical Supervision" function of a Professional Nurse Advocate.
28
+
29
+ Unlike generic chatbots, it doesn't just "chat." It is grounded in the **A-EQUIP Model** (Advocating for Educating for Quality Improvement and Practice) and strictly adheres to the official NHS PNA Handbook.
30
+
31
+ ### Key Capabilities
32
+ * **Restorative Dialogue**: Asking reflective questions to help nurses process emotional challenges.
33
+ * **Policy Grounding**: Retrieving exact guidance from the A-EQUIP framework (Normative, Formative, and Restorative).
34
+ * **Safety First**: Hard-coded safety rails to distinguish educational support from clinical/crisis intervention.
35
+
36
+ ---
37
+
38
+ ## ⚙️ Under the Hood: The "Nurse Citizen Developer" Stack
39
+
40
+ We built this tool using a **Retrieval-Augmented Generation (RAG)** architecture, hosted entirely on Hugging Face Spaces using ZeroGPU.
41
+
42
+ ### 1. The Brain: Gemma 2 2B IT 🧠
43
+ We chose Google's **Gemma 2 2B IT** (Instruction Tuned) as our foundation. Why?
44
+ * **Efficient**: It runs fast on renewable cloud resources.
45
+ * **Capable**: It has excellent reasoning capabilities for its size.
46
+ * **Open**: It aligns with our philosophy of open healthcare research.
47
+
48
+ ### 2. The Knowledge: RAG 📚
49
+ To prevent hallucinations (AI making things up), we don't rely solely on the model's training data. Instead, we use RAG:
50
+ 1. **Knowledge Base**: We embedded the *PNA Handbook* and *A-EQUIP Guidance*.
51
+ 2. **Retrieval**: When you ask a question, the system searches these documents for the answer.
52
+ 3. **Generation**: The AI uses that official text to construct its response.
53
+
54
+ ### 3. The Persona: "Compassionate Instruction Tuning" ❤️
55
+ The "secret sauce" is the System Prompt. We didn't just tell it to be helpful; we told it to be a **Nurse**.
56
+ * *Legacy Challenge*: AI can sound robotic or overly solution-focused.
57
+ * *Our Solution*: We instructed the model to prioritize **Validation** and **Reflection** over immediate problem-solving, mirroring the core skills of a PNA.
58
+
59
+ ---
60
+
61
+ ## 🚀 Why "Citizen Development" Matters
62
+
63
+ This project proves that you don't need a Computer Science degree to build impactful health AI. You need clinical expertise and curiosity.
64
+
65
+ By taking ownership of the technology, we ensured that **Nursing Values**—compassion, safety, and advocacy—were baked into the code from Day 1. This isn't just an AI tool; it's a statement that nurses are ready to lead in the digital era.
66
+
67
+ ## 🎓 Research & Availability
68
+
69
+ The PNA Assistant is available today as a **Research Artifact**. We invite nursing researchers, educators, and digital health innovators to test it, break it, and build upon it.
70
+
71
+ * **Try the Model**: [Hugging Face Space](https://huggingface.co/spaces/NurseCitizenDeveloper/PNA-Assistant)
72
+ * **Read the Code**: [GitHub Repository](https://github.com/ClinyQAi/Professional-Nurse-Advocate-Assistant)
73
+
74
+ *Disclaimer: This tool is for educational and research simulation purposes only. It does not provide clinical diagnosis or crisis mental health support.*