initial commit for HF Space

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Sarah Bentley
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,12 @@
+---
+title: Harbor
+emoji: 🚢
+colorFrom: blue
+colorTo: green
+sdk: gradio
+sdk_version: 5.23.3
+python_version: "3.10"
+app_file: app.py
+pinned: false
+---
+

app.py

@@ -0,0 +1,452 @@
+"""
+Gradio Web Interface for Harbor Treatment Navigation Chatbot
+
+Landing page offers three paths:
+1. Quick Recommendations — enter a zip code, get nearby options inline
+2. Talk to a Human — compact crisis callout with phone number
+3. Get Personalized Advice — leads to the AI chatbot
+
+Run locally:
+    python app.py
+
+Access in browser:
+    http://localhost:7860
+"""
+
+import os
+import re
+
+import gradio as gr
+from src.chat import Chatbot
+from src.utils.profile import create_empty_profile
+from src.utils.resources import load_resources, filter_resources, score_resources
+
+
+# ── CSS ───────────────────────────────────────────────────────────────────────
+
+CSS = """
+/* ── Layout ── */
+.harbor-wrap {
+    max-width: 680px;
+    margin: 0 auto;
+    padding: 2.5rem 1.25rem 1.5rem;
+    font-family: 'Inter', sans-serif;
+}
+
+/* ── Header ── */
+.harbor-logo {
+    text-align: center;
+    font-size: 2.75rem;
+    font-weight: 800;
+    letter-spacing: -1px;
+    color: #0d6e6e;
+    margin-bottom: 0.2rem;
+    line-height: 1;
+}
+.harbor-tagline {
+    text-align: center;
+    font-size: 1.1rem;
+    color: #5a7a7a;
+    margin-bottom: 2.25rem;
+    font-style: italic;
+}
+
+/* ── Cards ── */
+.harbor-card {
+    background: #ffffff;
+    border: 1.5px solid #c8e6e6;
+    border-radius: 16px;
+    padding: 1.5rem 1.75rem;
+    margin-bottom: 1.1rem;
+    box-shadow: 0 2px 12px rgba(13, 110, 110, 0.06);
+}
+.harbor-card-title {
+    font-size: 1.15rem;
+    font-weight: 700;
+    color: #0d6e6e;
+    margin-bottom: 0.6rem;
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+}
+.harbor-card p {
+    color: #3d5a5a;
+    line-height: 1.65;
+    margin: 0 0 0.75rem;
+    font-size: 0.97rem;
+}
+.harbor-card p:last-child { margin-bottom: 0; }
+
+/* ── Quick Rec card — larger, featured ── */
+.harbor-card-featured {
+    background: linear-gradient(145deg, #f0fafa, #e6f7f7);
+    border: 2px solid #0d9e8f;
+}
+.harbor-card-featured .harbor-card-title {
+    font-size: 1.25rem;
+}
+
+/* ── Crisis callout — compact ── */
+.harbor-callout {
+    background: #f8fffd;
+    border: 1.5px solid #c8e6e6;
+    border-radius: 12px;
+    padding: 0.9rem 1.25rem;
+    margin-bottom: 1.1rem;
+    display: flex;
+    align-items: center;
+    gap: 1rem;
+    flex-wrap: wrap;
+    box-shadow: 0 1px 6px rgba(13, 110, 110, 0.05);
+}
+.harbor-callout-text {
+    flex: 1;
+    min-width: 200px;
+    font-size: 0.9rem;
+    color: #3d5a5a;
+    line-height: 1.5;
+}
+.harbor-callout-text strong { color: #0d6e6e; }
+.harbor-phone-inline {
+    font-size: 1.2rem;
+    font-weight: 800;
+    color: #0d6e6e;
+    white-space: nowrap;
+}
+.harbor-phone-inline a { color: inherit; text-decoration: none; }
+.harbor-phone-inline a:hover { text-decoration: underline; }
+
+/* ── Zip results area ── */
+.harbor-results {
+    margin-top: 1rem;
+    padding-top: 1rem;
+    border-top: 1px solid #c8e6e6;
+}
+.harbor-results-title {
+    font-size: 1rem;
+    font-weight: 600;
+    color: #0d6e6e;
+    margin-bottom: 0.5rem;
+}
+.harbor-error {
+    color: #c0392b;
+    font-size: 0.9rem;
+    margin-top: 0.4rem;
+}
+#zip-results .pending,
+#zip-results .generating,
+#zip-results > .wrap,
+#zip-results > .svelte-spinner,
+#zip-results .eta-bar {
+    display: none !important;
+}
+
+/* ── Buttons ── */
+.harbor-start-btn button,
+.harbor-zip-btn button {
+    background: linear-gradient(135deg, #0d9e8f, #0d6e6e) !important;
+    border: none !important;
+    border-radius: 12px !important;
+    font-size: 1.05rem !important;
+    font-weight: 600 !important;
+    letter-spacing: 0.2px !important;
+    padding: 0.85rem 1.5rem !important;
+    transition: opacity 0.2s ease !important;
+    box-shadow: 0 4px 14px rgba(13, 110, 110, 0.25) !important;
+}
+.harbor-start-btn button:hover,
+.harbor-zip-btn button:hover { opacity: 0.9 !important; }
+
+/* ── Footer ── */
+.harbor-footer {
+    text-align: center;
+    font-size: 0.8rem;
+    color: #8fa8a8;
+    margin-top: 1.75rem;
+    line-height: 1.6;
+}
+
+/* ── Chat page ── */
+.chat-header {
+    max-width: 680px;
+    margin: 0 auto;
+    padding: 1.25rem 1.25rem 0;
+}
+.chat-back-btn button {
+    background: transparent !important;
+    border: 1.5px solid #c8e6e6 !important;
+    color: #0d6e6e !important;
+    border-radius: 8px !important;
+    font-size: 0.9rem !important;
+    font-weight: 500 !important;
+    padding: 0.4rem 0.9rem !important;
+}
+.chat-back-btn button:hover { background: #f0fafa !important; }
+"""
+
+# ── Theme ─────────────────────────────────────────────────────────────────────
+
+THEME = gr.themes.Soft(
+    primary_hue="teal",
+    secondary_hue="cyan",
+    neutral_hue="slate",
+    font=[gr.themes.GoogleFont("Inter"), "sans-serif"],
+).set(
+    button_primary_background_fill="linear-gradient(135deg, #0d9e8f, #0d6e6e)",
+    button_primary_background_fill_hover="linear-gradient(135deg, #0bb8a8, #0d9e8f)",
+    button_primary_text_color="#ffffff",
+    block_border_color="#c8e6e6",
+    block_shadow="0 2px 12px rgba(13,110,110,0.06)",
+)
+
+# ── Static HTML snippets ───────────────────────────────────────────────────────
+
+HEADER_MD = """
+<div class='harbor-logo'>⚓ Harbor</div>
+<div class='harbor-tagline'>Come in from the storm.</div>
+"""
+
+CRISIS_CALLOUT_HTML = """
+<div class='harbor-callout'>
+  <div class='harbor-callout-text'>
+    <strong>🤝 Talk to a Human</strong> — Trained counselors available
+    <strong>24/7</strong> through the Behavioral Health Help Line.<br>
+    <span style='font-size:0.82rem; color:#6b8e8e;'>
+      In immediate danger? <strong style='color:#6b4e4e;'>Call 911.</strong>
+    </span>
+  </div>
+  <div class='harbor-phone-inline'><a href='tel:8337732445'>📞 833-773-2445</a></div>
+</div>
+"""
+
+CHATBOT_CARD_MD = """
+<div class='harbor-card-title'>💬 Get Personalized Guidance</div>
+<p>
+  Want to explore options in more depth? Our chatbot can factor in your insurance,
+  preferences, treatment history, and more — no judgment, no pressure.
+</p>
+"""
+
+FOOTER_MD = """
+<div class='harbor-footer'>
+  Harbor does not provide medical advice, diagnosis, or treatment.<br>
+  If you are in crisis, please call 911 or the BHHL at 833-773-2445.
+</div>
+"""
+
+# ── Helpers ───────────────────────────────────────────────────────────────────
+
+ZIPCODE_RE = re.compile(r"^\d{5}$")
+
+
+def is_valid_zip(zipcode: str) -> bool:
+    """Return True if zipcode is exactly 5 digits."""
+    return bool(ZIPCODE_RE.match(zipcode.strip()))
+
+
+def _load_resources_once():
+    """Load resource CSVs once and cache."""
+    if not hasattr(_load_resources_once, "_cache"):
+        current_dir = os.path.dirname(os.path.abspath(__file__))
+        paths = [
+            os.path.join(current_dir, "references", "knowledge", "ma_resources.csv"),
+            os.path.join(current_dir, "references", "knowledge", "boston_resources.csv"),
+        ]
+        _load_resources_once._cache = load_resources(paths)
+    return _load_resources_once._cache
+
+
+def get_recommendations(zipcode: str) -> list[dict]:
+    """
+    Return a list of treatment recommendations for the given zip code.
+
+    Uses the same filter/score logic as the chatbot, but with a minimal
+    profile containing only the zipcode.
+    """
+    profile = create_empty_profile()
+    profile["logistics"]["zipcode"] = zipcode.strip()
+
+    resources = _load_resources_once()
+    filtered = filter_resources(resources, profile)
+    top = score_resources(filtered, profile)
+    return top
+
+
+def format_recommendations(zipcode: str, results: list[dict]) -> str:
+    """Render recommendations as an HTML snippet for display."""
+    if not results:
+        return (
+            f"<div class='harbor-results'>"
+            f"<div class='harbor-results-title'>Results near {zipcode}</div>"
+            f"<p style='color:#5a7a7a; font-size:0.93rem;'>"
+            f"No results found for that zip code yet. Try the chatbot below for "
+            f"more personalised help.</p>"
+            f"</div>"
+        )
+
+    items_html = ""
+    for r in results:
+        name = r.get("name", "Unknown Facility")
+        # Build address from parts
+        addr_parts = [r.get("address", ""), r.get("city", ""),
+                      r.get("state", ""), r.get("zip", "")]
+        address = ", ".join(p.strip() for p in addr_parts if p.strip())
+        phone = r.get("phone", "").strip()
+        # Type from primary_focus
+        focus = r.get("primary_focus", "").strip()
+        type_label = ", ".join(
+            v.strip().replace("_", " ").title() for v in focus.split("|")
+        ) if focus else ""
+
+        items_html += (
+            f"<div style='margin-bottom:0.75rem; padding:0.75rem; background:#f8fffd; "
+            f"border-radius:10px; border:1px solid #c8e6e6;'>"
+            f"<strong style='color:#0d6e6e;'>{name}</strong><br>"
+        )
+        if type_label or address:
+            items_html += (
+                f"<span style='font-size:0.88rem; color:#5a7a7a;'>"
+                f"{type_label + ' · ' if type_label else ''}{address}</span><br>"
+            )
+        if phone:
+            items_html += (
+                f"<a href='tel:{phone}' style='font-size:0.88rem; color:#0d9e8f;'>{phone}</a>"
+            )
+        items_html += "</div>"
+    return (
+        f"<div class='harbor-results'>"
+        f"<div class='harbor-results-title'>📍 Options near {zipcode}</div>"
+        f"{items_html}"
+        f"</div>"
+    )
+
+
+# ── App ───────────────────────────────────────────────────────────────────────
+
+def create_chatbot():
+    """Creates the Harbor interface with a landing page and chatbot."""
+    _load_resources_once()          # pre-load CSVs so first zip lookup is fast
+    chatbot = Chatbot()
+
+    def chat(message, history):
+        """
+        Generate a response for the current message.
+
+        Args:
+            message (str): The current message from the user
+            history (list): List of previous [user, assistant] message pairs
+
+        Returns:
+            str: The assistant's response
+        """
+        return chatbot.get_response(message)
+
+    def handle_zip_submit(zipcode: str):
+        """Validate zip and return inline results HTML."""
+        zipcode = zipcode.strip()
+        if not is_valid_zip(zipcode):
+            return gr.update(
+                value="<div class='harbor-error'>⚠️ Please enter a valid 5-digit zip code.</div>",
+                visible=True,
+            )
+        results = get_recommendations(zipcode)
+
+        # Log recommendations to console
+        if results:
+            print(f"[Harbor] Zip lookup ({zipcode}) — {len(results)} recommendation(s):")
+            for i, r in enumerate(results, 1):
+                print(f"  {i}. {r.get('name', 'Unknown')} — {r.get('city', '')}, {r.get('state', '')} {r.get('zip', '')}")
+        else:
+            print(f"[Harbor] Zip lookup ({zipcode}) — no results found.")
+
+        return gr.update(value=format_recommendations(zipcode, results), visible=True)
+
+    def show_chat():
+        return gr.update(visible=False), gr.update(visible=True)
+
+    def show_landing():
+        return gr.update(visible=True), gr.update(visible=False)
+
+    with gr.Blocks(title="Harbor", theme=THEME, css=CSS) as demo:
+
+        # ── Landing Page ──────────────────────────────────────────────
+        with gr.Column(visible=True) as landing_page:
+            with gr.Column(elem_classes="harbor-wrap"):
+                gr.HTML(HEADER_MD)
+
+                # Card 1 — Quick Recommendations (featured)
+                with gr.Group(elem_classes="harbor-card harbor-card-featured"):
+                    gr.HTML("<div class='harbor-card-title'>📍 Find Options Near You</div>")
+                    gr.HTML(
+                        "<p>Enter your zip code and we'll show you nearby treatment "
+                        "programs right away — no account needed.</p>"
+                    )
+                    with gr.Row():
+                        zip_input = gr.Textbox(
+                            placeholder="e.g. 02134",
+                            max_lines=1,
+                            show_label=False,
+                            container=False,
+                            scale=3,
+                        )
+                        zip_btn = gr.Button(
+                            "Find Options →",
+                            variant="primary",
+                            scale=1,
+                            elem_classes="harbor-zip-btn",
+                        )
+                # Results rendered outside the card so the loading spinner
+                # does not overlay the input card above.
+                results_html = gr.HTML(visible=False, elem_id="zip-results")
+
+                # Card 2 — Crisis callout (compact)
+                gr.HTML(CRISIS_CALLOUT_HTML)
+
+                # Card 3 — Chatbot
+                with gr.Group(elem_classes="harbor-card"):
+                    gr.HTML(CHATBOT_CARD_MD)
+                    start_chat_btn = gr.Button(
+                        "Start a Conversation →",
+                        variant="primary",
+                        size="lg",
+                        elem_classes="harbor-start-btn",
+                    )
+
+                gr.HTML(FOOTER_MD)
+
+        # ── Chat Page ─────────────────────────────────────────────────
+        with gr.Column(visible=False) as chat_page:
+            with gr.Column(elem_classes="chat-header"):
+                back_btn = gr.Button(
+                    "← Back to Home",
+                    size="sm",
+                    variant="secondary",
+                    elem_classes="chat-back-btn",
+                )
+            gr.ChatInterface(
+                chat,
+                title="⚓ Harbor",
+                description=(
+                    "Tell me a little about your situation and I'll help you find "
+                    "treatment options that match your needs. Everything is confidential."
+                ),
+                examples=[
+                    "What treatment options are available near me?",
+                    "I'm looking for outpatient help with alcohol use.",
+                    "I need support but I don't have insurance.",
+                    "How do I know which type of program is right for me?",
+                ],
+            )
+
+        # ── Events ────────────────────────────────────────────────────
+        zip_btn.click(handle_zip_submit, inputs=zip_input, outputs=results_html)
+        zip_input.submit(handle_zip_submit, inputs=zip_input, outputs=results_html)
+        start_chat_btn.click(show_chat, outputs=[landing_page, chat_page])
+        back_btn.click(show_landing, outputs=[landing_page, chat_page])
+
+    return demo
+
+
+if __name__ == "__main__":
+    demo = create_chatbot()
+    demo.launch()

data/system_prompt.md

@@ -0,0 +1,196 @@
+ 
+
+Treatment Navigation Chatbot — System Prompt
+
+Role / Identity
+
+You are a supportive assistant that helps people find treatment options for substance use or mental health care and guides them toward contacting appropriate treatment facilities.
+
+Scope / Boundaries
+
+Only assist with discovering and accessing mental health or substance use treatment services. If users ask unrelated questions, politely redirect the conversation back to treatment support.
+
+If a user indicates they may be in immediate crisis or danger, pause the normal conversation and encourage them to contact the Behavioral Health Help Line (BHHL).
+
+Crisis support information:
+
+Behavioral Health Help Line (BHHL)
+
+Call or text: 833-773-2445
+
+Available 24 hours a day, 7 days a week, 365 days a year.
+
+Anyone may contact the Help Line if they or a family member are experiencing a mental health or substance use disorder crisis.
+
+Tone / Style
+
+Be warm, patient, supportive, and non-judgmental. Use plain language and avoid clinical jargon.
+
+Use motivational interviewing techniques:
+
+\- Ask open-ended questions
+
+\- Reflect the user’s concerns
+
+\- Affirm their effort in seeking help
+
+\- Avoid lecturing, pushing, or shaming
+
+Respect the user’s autonomy and pace.
+
+Key Facts
+
+Users often hesitate to seek treatment due to stigma, fear, cost concerns, or uncertainty about what treatment involves.
+
+Treatment settings may include:
+
+\- outpatient care
+
+\- intensive outpatient care
+
+\- residential/inpatient programs
+
+\- telehealth services
+
+Matching users to facilities requires understanding:
+
+\- type of help needed
+
+\- preferred treatment setting
+
+\- payment method or insurance
+
+\- location
+
+\- special preferences such as language, LGBTQ+ affirming care, veterans services, adolescent services, or pregnancy-related care
+
+Behavior Rules
+
+1\. Engage
+
+Build rapport and understand the user’s situation with open-ended questions.
+
+2\. Educate
+
+If the user is uncertain about treatment, normalize help-seeking and explain what treatment typically involves.
+
+3\. Assess
+
+Ask a short set of questions to understand their needs:
+
+\- type of help
+
+\- treatment setting
+
+\- payment method
+
+\- location
+
+\- optional preferences
+
+4\. Match
+
+Present 3–5 treatment facilities that best match the user’s needs. Explain why each facility fits.
+
+5\. Empower
+
+Explain what happens when contacting a facility and what the intake process usually looks like.
+
+6\. Plan
+
+Encourage a concrete next step, such as calling a facility. Provide a simple call script.
+
+7\. Follow-through
+
+Offer encouragement and help the user make a plan for when they will contact the facility.
+
+Guardrails
+
+Source of Truth
+
+Only recommend facilities that come from an approved, up-to-date treatment directory or database provided to the assistant. Do not invent, infer, or guess facility names, addresses, phone numbers, hours, or services. If verified facility data is unavailable, say so clearly and offer general guidance instead.
+
+Verification and Uncertainty
+
+Do not claim that a facility has current availability, accepts a specific insurance plan, or offers a specific service unless that information is present in the source data. Remind the user to call the facility before visiting to confirm services, eligibility, hours, and payment details.
+
+Crisis Escalation
+
+If the user describes immediate danger, overdose risk, suicidal intent, intent to harm others, severe withdrawal, or another urgent behavioral health crisis, do not continue with routine matching questions until safety is addressed. First encourage immediate contact with the Behavioral Health Help Line at 833-773-2445 by call or text. If the situation appears life-threatening or time-sensitive, urge the user to call emergency services right away.
+
+Crisis Threshold Protocol
+
+The assistant must switch to crisis support mode if the user indicates:
+
+Self-harm or suicide risk
+
+\- expressing suicidal thoughts
+
+\- wanting to die
+
+\- planning or considering self-harm
+
+\- expressing hopelessness about continuing
+
+Risk of harming others
+
+\- stating intent to harm another person
+
+\- describing imminent violent behavior
+
+Overdose or severe substance use emergency
+
+\- possible overdose
+
+\- severe withdrawal symptoms
+
+\- loss of consciousness
+
+\- inability to breathe normally
+
+Acute mental health crisis
+
+\- panic that feels uncontrollable
+
+\- hallucinations or extreme confusion
+
+\- inability to stay safe
+
+Third-party crisis
+
+\- the user says a family member or friend is currently in danger or crisis
+
+Crisis Response Template
+
+I'm really sorry you're going through something this difficult. You don't have to handle it alone.
+
+If you or someone near you may be in immediate danger, please call 911 right now.
+
+You can also reach the Behavioral Health Help Line (BHHL) for immediate support. They are available 24 hours a day, 7 days a week, 365 days a year.
+
+Call or text: 833-773-2445
+
+Trained counselors can talk with you and help figure out the next step.
+
+If you'd like, you can also tell me a little about what's happening and I can help you think through what to do next.
+
+Output Format
+
+When recommending facilities, present them clearly:
+
+Facility Name
+
+Address
+
+Phone number
+
+Why this matches you:
+
+Short explanation referencing the user’s needs.
+
+Services:
+
+Key treatment services offered.
+
+After listing facilities, ask whether the user would like help contacting one of them or making a plan for next steps.
+

data/user_profile_schema.json

@@ -0,0 +1,191 @@
+{
+  "demographics": {
+    "population": {
+      "description": "User's age group or life stage",
+      "type": "single",
+      "options": [
+        {"value": "adolescent", "label": "Adolescent / Minor", "keywords": ["teen", "teenager", "adolescent", "minor", "kid", "child", "youth", "young", "high school", "middle school"], "cite": [7, 627]},
+        {"value": "young_adult", "label": "Young Adult / College Student", "keywords": ["college", "university", "student", "young adult", "campus", "dorm", "undergrad", "graduate student"], "cite": [120, 346]},
+        {"value": "adult", "label": "General Adult", "keywords": [], "cite": [212]},
+        {"value": "older_adult", "label": "Older Adult", "keywords": ["older", "elderly", "senior", "retired", "retirement", "aging"], "cite": [446, 967]}
+      ]
+    },
+    "identity_factors": {
+      "description": "Core identity factors relevant to treatment matching",
+      "type": "multi",
+      "options": [
+        {"value": "veteran", "label": "Veteran", "keywords": ["veteran", "military", "army", "navy", "marines", "air force", "service member", "deployed", "combat", "VA"], "cite": [65]},
+        {"value": "lgbtq", "label": "LGBTQ+", "keywords": ["lgbtq", "gay", "lesbian", "bisexual", "transgender", "trans", "queer", "nonbinary", "non-binary"], "cite": [258]},
+        {"value": "wheelchair_user", "label": "Wheelchair User", "keywords": ["wheelchair", "mobility aid", "mobility impairment"], "cite": [918]},
+        {"value": "woman", "label": "Woman", "keywords": ["woman", "female", "mother", "mom", "daughter", "wife", "girl"], "cite": []},
+        {"value": "homeless", "label": "Homeless / Unhoused", "keywords": ["homeless", "unhoused", "shelter", "no place to stay", "living on the street", "couch surfing"], "cite": [860]},
+        {"value": "autistic", "label": "Autistic / Neurodivergent", "keywords": ["autistic", "autism", "neurodivergent", "adhd", "on the spectrum"], "cite": []}
+      ]
+    },
+    "language": {
+      "description": "Preferred language for treatment",
+      "type": "single",
+      "options": [
+        {"value": "english", "label": "English", "keywords": ["english"], "cite": [173]},
+        {"value": "spanish", "label": "Spanish", "keywords": ["spanish", "español", "espanol", "habla español"], "cite": [171, 173]}
+      ]
+    },
+    "pronouns": {
+      "description": "User's pronouns",
+      "type": "single",
+      "options": [
+        {"value": "he", "label": "He/Him", "keywords": ["he/him"], "cite": []},
+        {"value": "she", "label": "She/Her", "keywords": ["she/her"], "cite": []},
+        {"value": "they", "label": "They/Them", "keywords": ["they/them"], "cite": [267]}
+      ]
+    }
+  },
+  "logistics": {
+    "zipcode": {
+      "description": "User's ZIP code for proximity-based facility matching",
+      "type": "extracted",
+      "pattern": "\\b\\d{5}\\b"
+    },
+    "region": {
+      "description": "Broader region or area description (city, county, state, or rural designation)",
+      "type": "extracted",
+      "examples": ["Boston", "Pocahontas County", "rural West Virginia"]
+    },
+    "profession": {
+      "description": "Long-term profession relevant to treatment (e.g., licensing fears, scheduling)",
+      "type": "single",
+      "options": [
+        {"value": "healthcare_worker", "label": "Healthcare Worker / Nurse", "keywords": ["nurse", "doctor", "healthcare worker", "hospital", "medical professional", "EMT", "paramedic", "physician"], "cite": [793]},
+        {"value": "mental_health_professional", "label": "Mental Health Professional / Therapist", "keywords": ["therapist", "counselor", "psychologist", "psychiatrist", "social worker", "mental health professional"], "cite": [1021]},
+        {"value": "first_responder", "label": "First Responder", "keywords": ["firefighter", "police", "officer", "first responder", "law enforcement"], "cite": []}
+      ]
+    },
+    "accessibility_needs": {
+      "description": "Physical accessibility requirements for facilities",
+      "type": "multi",
+      "options": [
+        {"value": "wheelchair_accessible", "label": "Wheelchair Accessible / ADA", "keywords": ["wheelchair accessible", "ada accessible", "accessibility", "ramp", "elevator"], "cite": [918]}
+      ]
+    },
+    "insurance": {
+      "description": "Payment or insurance method",
+      "type": "single",
+      "options": [
+        {"value": "private", "label": "Private Insurance", "keywords": ["insurance", "blue cross", "aetna", "cigna", "united health", "anthem", "humana", "private insurance", "employer insurance", "work insurance"], "cite": [26, 527, 607]},
+        {"value": "medicaid_medicare", "label": "Medicaid / Medicare", "keywords": ["medicaid", "medicare", "masshealth", "state insurance"], "cite": [171, 464, 527]},
+        {"value": "va_tricare", "label": "VA Benefits / TRICARE", "keywords": ["va benefits", "tricare", "veterans affairs", "va insurance", "military insurance"], "cite": [84, 89]},
+        {"value": "uninsured", "label": "Uninsured / Self-Pay", "keywords": ["uninsured", "no insurance", "self-pay", "self pay", "pay out of pocket", "can't afford", "sliding scale", "free"], "cite": [120, 527]}
+      ]
+    },
+    "treatment_history": {
+      "description": "Previous treatment experiences",
+      "type": "extracted",
+      "examples": ["prior 12-step residential", "been to rehab before", "tried outpatient"],
+      "cite": [752, 759, 762]
+    }
+  },
+  "status": {
+    "current_state": {
+      "description": "User's current sobriety or intoxication state",
+      "type": "single",
+      "options": [
+        {"value": "sober", "label": "Sober", "keywords": ["sober", "clean", "not using", "in recovery"], "cite": [459]},
+        {"value": "intoxicated", "label": "Currently Intoxicated / Incoherent", "keywords": ["drunk", "high", "intoxicated", "wasted", "messed up", "using right now"], "cite": [564, 567]}
+      ]
+    },
+    "crisis_level": {
+      "description": "Level of distress or crisis",
+      "type": "single",
+      "options": [
+        {"value": "general_distress", "label": "General Distress", "keywords": ["stressed", "overwhelmed", "struggling", "having a hard time", "not doing well"], "cite": [122]},
+        {"value": "acute_crisis", "label": "Acute Distress / Suicidal Ideation", "keywords": ["suicidal", "kill myself", "want to die", "end it", "overdose", "can't go on", "hurt myself", "self-harm", "no reason to live"], "cite": [212, 215]}
+      ]
+    },
+    "temporary_factors": {
+      "description": "Temporary life circumstances affecting treatment needs",
+      "type": "multi",
+      "options": [
+        {"value": "pregnant", "label": "Pregnant / Postpartum", "keywords": ["pregnant", "pregnancy", "postpartum", "expecting", "baby on the way", "just had a baby"], "cite": [300]},
+        {"value": "homeless", "label": "Homeless / Unhoused", "keywords": ["homeless", "unhoused", "shelter", "no place to stay", "living on the street"], "cite": [860]},
+        {"value": "court_mandated", "label": "Court-Mandated", "keywords": ["court", "mandated", "judge", "probation", "parole", "court-ordered", "legal requirement"], "cite": [828, 831]}
+      ]
+    }
+  },
+  "clinical": {
+    "primary_focus": {
+      "description": "Primary reason for seeking help",
+      "type": "single",
+      "options": [
+        {"value": "substance_use", "label": "Alcohol or Drug Use", "keywords": ["drinking", "drug", "substance", "addiction", "using", "habit", "dependence"], "cite": [518]},
+        {"value": "mental_health", "label": "Mental Health", "keywords": ["anxiety", "depression", "trauma", "ptsd", "bipolar", "panic", "mental health", "therapy", "counseling"], "cite": [518]},
+        {"value": "dual_diagnosis", "label": "Both (Co-occurring)", "keywords": ["both", "dual diagnosis", "co-occurring", "mental health and substance", "depression and drinking"], "cite": [518, 522]},
+        {"value": "unsure", "label": "Unsure", "keywords": ["not sure", "don't know", "unsure", "maybe", "i think"], "cite": [518]}
+      ]
+    },
+    "substances": {
+      "description": "Specific substances involved",
+      "type": "multi",
+      "options": [
+        {"value": "alcohol", "label": "Alcohol", "keywords": ["alcohol", "drinking", "beer", "wine", "liquor", "booze", "drunk"], "cite": [65]},
+        {"value": "opioids", "label": "Opioids", "keywords": ["opioid", "heroin", "fentanyl", "pills", "oxy", "oxycontin", "percocet", "vicodin", "painkiller", "opiate"], "cite": [171, 867]},
+        {"value": "stimulants", "label": "Meth / Stimulants", "keywords": ["meth", "methamphetamine", "cocaine", "crack", "stimulant", "adderall", "amphetamine", "speed", "coke"], "cite": [595, 867]},
+        {"value": "cannabis", "label": "Cannabis", "keywords": ["marijuana", "cannabis", "weed", "pot", "thc", "edibles", "smoking weed"], "cite": [7]},
+        {"value": "benzodiazepines", "label": "Benzodiazepines", "keywords": ["benzo", "benzodiazepine", "xanax", "valium", "klonopin", "ativan"], "cite": []},
+        {"value": "other", "label": "Other Substance", "keywords": [], "cite": []}
+      ]
+    }
+  },
+  "preferences": {
+    "setting": {
+      "description": "Preferred treatment setting",
+      "type": "single",
+      "options": [
+        {"value": "outpatient", "label": "Outpatient", "keywords": ["outpatient", "appointments", "weekly visits", "not live there"], "cite": [523]},
+        {"value": "intensive_outpatient", "label": "Intensive Outpatient (IOP)", "keywords": ["intensive outpatient", "iop", "partial hospitalization", "day program"], "cite": [523]},
+        {"value": "residential", "label": "Residential / Inpatient", "keywords": ["residential", "inpatient", "rehab", "live-in", "live there", "stay there", "30-day", "90-day"], "cite": [523]},
+        {"value": "telehealth", "label": "Telehealth", "keywords": ["telehealth", "online", "virtual", "video", "remote", "from home", "phone appointment"], "cite": [523]}
+      ]
+    },
+    "therapy_approach": {
+      "description": "Preferred therapeutic approach",
+      "type": "single",
+      "options": [
+        {"value": "mat", "label": "Medication-Assisted Treatment (MAT)", "keywords": ["mat", "medication-assisted", "suboxone", "methadone", "naltrexone", "vivitrol", "medication treatment", "medically assisted"], "cite": [171, 765]},
+        {"value": "cbt", "label": "Cognitive Behavioral Therapy (CBT)", "keywords": ["cbt", "cognitive behavioral", "talk therapy", "behavioral therapy"], "cite": [31, 146]},
+        {"value": "twelve_step", "label": "12-Step", "keywords": ["12-step", "twelve step", "aa", "na", "alcoholics anonymous", "narcotics anonymous", "sponsor", "higher power"], "cite": [759]},
+        {"value": "medication_only", "label": "Medication Only (No Counseling)", "keywords": ["medication only", "just medication", "no counseling", "no therapy", "just pills", "just meds"], "cite": [991, 993]}
+      ]
+    },
+    "scheduling": {
+      "description": "Scheduling constraints",
+      "type": "multi",
+      "options": [
+        {"value": "evening_weekend", "label": "Evening / Weekend Hours", "keywords": ["evening", "weekend", "after work", "night", "saturday", "sunday", "after hours"], "cite": [535]},
+        {"value": "after_school", "label": "After-School Scheduling", "keywords": ["after school", "after class", "afternoon"], "cite": [31, 35]}
+      ]
+    },
+    "barriers": {
+      "description": "Primary barriers to seeking treatment",
+      "type": "multi",
+      "options": [
+        {"value": "stigma", "label": "Stigma / Shame", "keywords": ["ashamed", "embarrassed", "stigma", "shame", "what people think", "judged", "judgment"], "cite": [7, 301]},
+        {"value": "fear_of_labeling", "label": "Fear of Labeling", "keywords": ["label", "labeled", "addict", "alcoholic", "don't want to be called"], "cite": [7]},
+        {"value": "denial", "label": "Denial / Uncertainty", "keywords": ["not sure if", "maybe i don't", "is it really", "not that bad", "i can stop"], "cite": [346]},
+        {"value": "cost", "label": "Cost", "keywords": ["cost", "expensive", "afford", "money", "price", "cheap", "budget"], "cite": [120]},
+        {"value": "legal_fear", "label": "Fear of Legal Consequences", "keywords": ["custody", "lose my kids", "license", "lose my job", "arrested", "legal", "fired"], "cite": [301, 796]},
+        {"value": "geographic_isolation", "label": "Geographic Isolation", "keywords": ["rural", "far away", "no providers", "nothing nearby", "middle of nowhere", "long drive"], "cite": [684, 686]},
+        {"value": "phone_anxiety", "label": "Phone Anxiety", "keywords": ["hate calling", "don't want to call", "phone anxiety", "can't call", "nervous to call", "scared to call"], "cite": [396, 419]}
+      ]
+    },
+    "contact_channel": {
+      "description": "Preferred way to be contacted or reach out",
+      "type": "single",
+      "options": [
+        {"value": "text", "label": "Text Message", "keywords": ["text", "text me", "sms", "message"], "cite": [164, 555]},
+        {"value": "phone", "label": "Phone Call", "keywords": ["call", "phone", "call me"], "cite": [488, 712]},
+        {"value": "email", "label": "Email", "keywords": ["email", "e-mail"], "cite": [295]},
+        {"value": "discreet", "label": "Discreet / Confidential Messaging", "keywords": ["discreet", "confidential", "private", "secret", "no one know"], "cite": [665, 821]}
+      ]
+    }
+  }
+}

references/knowledge/boston_resources.csv

@@ -0,0 +1,174 @@
+name,address,city,state,zip,phone,website,primary_focus,substances,age_groups,identity_factors,insurance,settings,therapy_approaches,languages,dmh_region,notes
+"Several DMH site offices also have VideoPhones, which can be used for direct communication between staff and",,Statewide,MA,,(978) 627-4468,,mental_health,,,,,,,english,Statewide,DMH Resource Directory 2025
+North County Site Office,,Statewide,MA,,(978) 627-4468,,mental_health,,,,,,,english,Statewide,DMH Resource Directory 2025
+Springfield Site Office,,Statewide,MA,,(413) 301-0914,,mental_health,,,,,,,english,Statewide,DMH Resource Directory 2025
+Metro North Site Office,,Statewide,MA,,(339) 219-6119,,mental_health,,,,,,,english,Statewide,DMH Resource Directory 2025
+DMH Site Office,,Statewide,MA,,(339) 219-6119,,mental_health,,,,,,,english,Statewide,DMH Resource Directory 2025
+Westborough Site Office,,Statewide,MA,,(508) 948-0605,,mental_health,,,,,,,english,Statewide,DMH Resource Directory 2025
+Lindemann/Cambridge/Somerville Site Office,,Statewide,MA,,(857) 366 4215,,mental_health,,,,,,,english,Statewide,DMH Resource Directory 2025
+"Lemuel Shattuck Hospital                             (617) 522-8110           Dr. Romas Buivydas, Ph.D.","7888       Chief of Psychiatric Operations
+Jamaica Pl",ain,MA,02130,(617) 522-8110,,mental_health,,,,,,,english,Metro Boston,DMH Resource Directory 2025
+Dr. Solomon Carter Fuller Mental Health Center       (617) 626-8700           Valencia Reid,"8929       Chief Operating Officer
+Bost",on,MA,02118,(617) 626-8700,,mental_health,,,,,,,english,Metro Boston,DMH Resource Directory 2025
+Taunton State Hospital                               Telephone #              Person in Charge,,"Chief Operating Officer
+Taunton",MA,02780,(508) 977-3000,,mental_health,,,,,,,english,Southeast,DMH Resource Directory 2025
+Tewksbury Hospital                       2859                 Chief of Psychiatric Operations,"4000       Kathy Wenzel
+Worcest",er,MA,01604,(978) 851-1029,,mental_health,,adult,,,,,english,Northeast,DMH Resource Directory 2025
+Worcester Recovery Center and Hospital   Telephone #          Person in Charge,"4000       Kathy Wenzel
+Worcest",er,MA,01604,(508) 368-4000,,mental_health,,adolescent|adult,,,,,english,Central MA,DMH Resource Directory 2025
+Fuller/Bay Cove Site Office                              Telephone #                   Person in Charge,"8884            Site Director
+      Bost",on,MA,02118,(617) 626-8944,,mental_health,,,,,,,english,Metro Boston,DMH Resource Directory 2025
+Dr. Solomon Carter Fuller Mental Health Center           (617) 626-8944                Patricia Cadet,"8884            Site Director
+      Bost",on,MA,02118,(617) 626-8944,,mental_health,,,,,,,english,Metro Boston,DMH Resource Directory 2025
+"Center/Cambridge/Somerville Site Office                  (617) 626-8500                Luis Borrero, MSW, LICSW","8515            Site Director
+      Bost",on,MA,02114,(617) 626-8500,,mental_health,,,,,,,english,Metro Boston,DMH Resource Directory 2025
+Massachusetts Mental Health Center Site Office           Telephone #                   Person in Charge,"9300                Rachel Steiner
+      Bost",on,MA,02115,(617) 626-9300,,mental_health,,,,,,,english,Metro Boston,DMH Resource Directory 2025
+Pocasset Mental Health Center                      Telephone #                  Person in Charge,,"LICSW
+Pocasset",MA,02559,(508) 564-9600,,mental_health,,,,,,,english,Southeast,DMH Resource Directory 2025
+Corrigan Mental Health Center                      Telephone #                  Person in Charge,,"LICSW
+Fall River",MA,02720,(508) 235-7200,,mental_health,,,,,,,english,Southeast,DMH Resource Directory 2025
+Brockton Site Office                                     Telephone #                        Person in Charge,2075                 Site Direct,"or
+   Brockton",MA,02302,(508) 897-2000,,mental_health,,,lgbtq,,,,english,Southeast,DMH Resource Directory 2025
+Cape Cod & The Islands Site Office                       Telephone #                        Person in Charge,7346                 Site Direct,"or
+   Fall River",MA,02720,(508) 957-0900,,mental_health,,,lgbtq,,,,english,Southeast,DMH Resource Directory 2025
+Fall River Site Office                                   Telephone #                        Person in Charge,7346                 Site Direct,"or
+   Fall River",MA,02720,(508) 235-7200,,mental_health,,,,,,,english,Southeast,DMH Resource Directory 2025
+"Corrigan Mental Health Center                            (508) 235-7200                     Jeanne Crespi, LICSW",7346                 Site Direct,"or
+   Fall River",MA,02720,(508) 235-7200,,mental_health,,,,,,,english,Southeast,DMH Resource Directory 2025
+New Bedford Site Office                                  Telephone #                        Person in Charge,,"LMHC
+   New Bedford",MA,02740,(508) 996-7900,,mental_health,,,,,,,english,Southeast,DMH Resource Directory 2025
+Plymouth Site Office                                     Telephone #                        Person in Charge,,"MSW
+   Plymouth",MA,02360,(508) 732-3000,,mental_health,,,,,,,english,Southeast,DMH Resource Directory 2025
+Quincy Site Office                                       Telephone #                 Person in Charge,,"Site Director
+   Quincy",MA,02169,(617) 984-1000,,mental_health,,,,,,,english,Southeast,DMH Resource Directory 2025
+"Quincy Mental Health Center                              (617) 984-1000              Laura Ruscio, MSW, LICSW",,"Site Director
+   Quincy",MA,02169,(617) 984-1000,,mental_health,,,,,,,english,Southeast,DMH Resource Directory 2025
+Taunton/Attleboro Site Office                            Telephone #                 Person in Charge,,"MA
+   Taunton",MA,02780,(508) 977-3174,,mental_health,,,,,,,english,Southeast,DMH Resource Directory 2025
+Acton Site Office                                       Telephone #                   Person in Charge,"2100                Alicia Stacy, MPA,","LSW
+Acton",MA,01720,(978) 206-2100,,mental_health,,,,,,,english,Northeast,DMH Resource Directory 2025
+Essex North Site Office                                 Telephone #                   Person in Charge,"4500                Steven Noroian,","LMHC
+Lawrence",MA,01843,(978) 738-4500,,mental_health,,,,,,,english,Northeast,DMH Resource Directory 2025
+Lowell Site Office                                      Telephone #                   Person in Charge,"5000                Gerard Frater, MSW,","LICSW
+Lowell",MA,01851,(978) 322-5000,,mental_health,,,,,,,english,Northeast,DMH Resource Directory 2025
+Lynn Site Office                                        Telephone #                   Person in Charge,"178 Albion Street, Suite 410                            Telephone #","Person in Charge
+Wakefield",MA,01880,(781) 477-2070,,mental_health,,,,,,,english,Northeast,DMH Resource Directory 2025
+Metro North Site Office,"178 Albion Street, Suite 410                            Telephone #","Person in Charge
+Wakefield",MA,01880,(781) 224-7900,,mental_health,,,,,,,english,Northeast,DMH Resource Directory 2025
+North Shore Site Office                                 Telephone #              Person in Charge,,"LMHC
+ Salem",MA,01970,(978) 741-7300,,mental_health,,,,,,,english,Northeast,DMH Resource Directory 2025
+North County Site Office                                      Telephone #                  Person in Charge,,"LMHC
+Fitchburg",MA,01420,(978) 353-4400,,mental_health,,adolescent,,,,,english,Central MA,DMH Resource Directory 2025
+South County Site Office                                      Telephone #                  Person in Charge,9721           Site Direct,"or
+Canton",MA,02021,(508) 887-1100,,mental_health,,adolescent,,,,,english,Central MA,DMH Resource Directory 2025
+Worcester Site Office                                         Telephone #                  Person in Charge,9721           Site Direct,"or
+Canton",MA,02021,(774) 420-3100,,mental_health,,adolescent,,,,,english,Central MA,DMH Resource Directory 2025
+Canton Site Office,9721           Site Direct,"or
+Canton",MA,02021,(781) 401-9700,,mental_health,,adolescent,,,,,english,Central MA,DMH Resource Directory 2025
+Pappas Rehabilitation Hospital for Children                   Telephone #                  Person in Charge,9721           Site Direct,"or
+Canton",MA,02021,(781) 401-9700,,mental_health,,adolescent,,,,,english,Central MA,DMH Resource Directory 2025
+Westborough Site Office                                      Telephone #           Person in Charge,"2864    Site Director
+ West",borough,MA,01581,(508) 616-2801,,mental_health,,,,,,,english,Central MA,DMH Resource Directory 2025
+Berkshire Site Office                                        Telephone #                 Person in Charge,,"LICSW
+Pittsfield",MA,01201,(413) 395-2000,,mental_health,,,,,,,english,Western MA,DMH Resource Directory 2025
+Franklin/North Quabbin Site Office                           Telephone #                 Person in Charge,,"LICSW
+Greenfield",MA,01301,(413) 772-5600,,mental_health,,,,,,,english,Western MA,DMH Resource Directory 2025
+Hampshire Site Office                                        Telephone #                 Person in Charge,,"LMHC
+Northampton",MA,01060,(413) 587-6200,,mental_health,,,,,,,english,Western MA,DMH Resource Directory 2025
+Holyoke/Chicopee Site Office                                 Telephone #                 Person in Charge,,"LCSW
+Springfield",MA,01104,(413) 452-2300,,mental_health,,,,,,,english,Western MA,DMH Resource Directory 2025
+Springfield Site Office                                     Telephone #              Person in Charge,"6200           Christine Fowle,","B.A.
+ Northampton",MA,01060,(413) 452-2300,,mental_health,,,,,,,english,Western MA,DMH Resource Directory 2025
+Westfield Site Office                                       Telephone #              Person in Charge,"6200           Christine Fowle,","B.A.
+ Northampton",MA,01060,(413) 587-6200,,mental_health,,,,,,,english,Western MA,DMH Resource Directory 2025
+"If you have any questions or comments about this directory, please contact the Office of Race,",,,MA,,(617) 626-8134,https://mass.gov/service-,mental_health,,,accessibility|immigrant_refugee|lgbtq,,,,english,Statewide,DMH Multicultural Directory 2019
+EMERGENCY LINE,,,MA,,877-382-1609,https://mass.gov/dmh,dual_diagnosis,,,,,,,english,Statewide,DMH Multicultural Directory 2019
+MASSACHUSETTS DEPARTMENT OF MENTAL HEALTH (DMH),"25 Staniford Street,",Boston,MA,02114,800-221-0053,https://mass.gov/dmh,mental_health,,,,,,,english,Statewide,DMH Multicultural Directory 2019
+Help is available for those with a drug or alcohol problem at helpline-online.org or,"250 Washington Street,",Boston,MA,02108,800-720-3480,https://mass.gov/eohhs/gov/departments/dph/programs/substance-abuse,dual_diagnosis,alcohol,adolescent,accessibility,,,,english,Statewide,DMH Multicultural Directory 2019
+HEARING (MCDHH),"600 Washington Street,",Boston,MA,02111,617-740-1600,https://mass.gov/eohhs/gov/departments/mcdhh,dual_diagnosis,,,accessibility|immigrant_refugee,,,,english,Statewide,DMH Multicultural Directory 2019
+MASSACHUSETTS OFFICE FOR REFUGEES AND IMMIGRANTS (MORI),"600 Washington Street,",Boston,MA,02111,617-727-7888,https://mass.gov/eohhs/gov/departments/ori,dual_diagnosis,,,accessibility|immigrant_refugee,,,,english,Statewide,DMH Multicultural Directory 2019
+MASS 2-1-1,,,MA,,877-211-6277,https://mass.gov/eohhs/gov/departments/ori/key-resources.html,dual_diagnosis,,,immigrant_refugee,,,,english,Statewide,DMH Multicultural Directory 2019
+MASSACHUSETTS REHABILITATION COMMISSION (MRC),"600 Washington Street,",Boston,MA,02111,617-204-3600,https://massoptions.org,dual_diagnosis,,older_adult,accessibility,,,,english|spanish,Statewide,DMH Multicultural Directory 2019
+ADVOCATES,,Framingham,MA,01701,800-640-5432,https://advocates.org,dual_diagnosis,,,accessibility,,,,english,Statewide,DMH Multicultural Directory 2019
+ASPERGER / AUTISM NETWORK,"51 Water Street, Suite 206,",Watertown,MA,02472,617- 393-3824,https://advocates.org,dual_diagnosis,,,,,,,english,Statewide,DMH Multicultural Directory 2019
+"BROCKTON AREA MULTI-SERVICES, INC. (BAMSI)",,Brockton,MA,02301,508-580-8700,https://baycove.org,dual_diagnosis,alcohol,adolescent|older_adult,accessibility,,,,cape_verdean_creole|english|portuguese,Statewide,DMH Multicultural Directory 2019
+"Helpline for health care, social services, financial assistance, housing, and food pantries:",,Brockton,MA,02301,508-584-4357,https://baycove.org,dual_diagnosis,alcohol,adolescent|older_adult,accessibility,,,,cape_verdean_creole|english|portuguese,Statewide,DMH Multicultural Directory 2019
+CAMBRIDGE HEALTH ALLIANCE,"1493 Cambridge Street,",Cambridge,MA,02139,617-665-1305,https://bamsi.org,dual_diagnosis,,adolescent,accessibility,,,,cape_verdean_creole|english|portuguese,Statewide,DMH Multicultural Directory 2019
+“LINK-KID”,,,MA,,855-456-5543,https://challiance.org,dual_diagnosis,,adolescent,accessibility,,,,cape_verdean_creole|english|portuguese,Statewide,DMH Multicultural Directory 2019
+DISABILITY LAW CENTER,"11 Beacon Street, Suite 925,",Boston,MA,02108,617-723-8455,https://deafinconline.org,mental_health,,adolescent,accessibility|lgbtq,,,,english|mandarin|portuguese|spanish,Statewide,DMH Multicultural Directory 2019
+FEDERATION FOR CHILDREN WITH SPECIAL NEEDS,"529 Main Street,",Boston,MA,02129,617-236-7210,https://frcma.org,mental_health,,adolescent,accessibility|lgbtq,,,,english|french|haitian_creole|mandarin|portuguese|spanish,Statewide,DMH Multicultural Directory 2019
+JAPANESE BOSTONIANS SUPPORT LINE,,,MA,,781-296-1800,https://hmhnetwork.org/boston-based-agencies,mental_health,,adult,accessibility,,residential,,english|japanese,Statewide,DMH Multicultural Directory 2019
+JUSTICE RESOURCE INSTITUTE,"160 Gould Street, Suite 300,",Needham,MA,02494,781-559-4900,https://hmhnetwork.org/boston-based-agencies,mental_health,,adult,accessibility,,residential,,english|japanese,Statewide,DMH Multicultural Directory 2019
+MASSACHUSETTS ADULT DAY SERVICES ASSOCIATION,"1 Florence Street,",Boston,MA,02131,617-469-5848,https://jri.org,mental_health,,adult,accessibility,,residential,,english,Statewide,DMH Multicultural Directory 2019
+MASSACHUSETTS LEAGUE OF COMMUNITY HEALTH CENTERS,"40 Court Street #10,",Boston,MA,02108,617-426-2225,https://masspartnership.com,dual_diagnosis,alcohol,adolescent,homeless|immigrant_refugee,,,,english,Statewide,DMH Multicultural Directory 2019
+MASSACHUSETTS ORGANIZATION FOR ADDICTION RECOVERY,"29 Winter Street, 2nd Floor,",Boston,MA,02108,617-423-6627,https://moar-recovery.org,dual_diagnosis,alcohol,adolescent,accessibility|homeless|immigrant_refugee,,,,english,Statewide,DMH Multicultural Directory 2019
+PARENT/PROFESSIONAL ADVOCACY LEAGUE (PPAL),,Boston,MA,02108,866-815-8122,https://nami.org,mental_health,,adolescent|adult|young_adult,woman,,,,bengali|english|gujarati|haitian_creole|hindi|nepali|punjabi|spanish|tamil|urdu,Statewide,DMH Multicultural Directory 2019
+SAHELI,,Burlington,MA,01803,866-472-4354,https://ppal.net/wp-content/uploads/2011/01/Child-,mental_health,,adolescent|adult|young_adult,accessibility|woman,,,,bengali|english|gujarati|haitian_creole|hindi|nepali|punjabi|spanish|tamil|urdu,Statewide,DMH Multicultural Directory 2019
+"1 Frederick Abbott Way, Framingham, MA 01701","1 Frederick Abbott Way,",Framingham,MA,01701,508-879-9800,https://transformation-center.org,dual_diagnosis,,adolescent|adult|older_adult|young_adult,accessibility|immigrant_refugee,,residential,,english|spanish,Statewide,DMH Multicultural Directory 2019
+Arbour Counseling Services ns/arbour-counseling-serv Asian American Civi Association 617-426-9492 Asian Task Force Agai Domestic Violence 617-338-2350 24 hour Multilingual Helpli 617-338-2355 2019 DMH MULTICU,P.O. Box 120108,Boston,MA,02112,617-782-6460,https://arbourhealth.com/organiz,mental_health,,adolescent|young_adult,,,residential,,bengali|cantonese|english|french|hebrew|hindi|italian|japanese|khmer|korean|lao|mandarin|nepali|russian|spanish|tagalog|thai|urdu|vietnamese,Metro Boston,DMH Multicultural Directory 2019
+"Association of Haitia Women in Boston Boston Alliance of Ga Lesbian, Bisexual, an Transgender Youth In 617-227-4313 Boston Asian: Youth Essential Service, Inc 617-482-4243 Boston Center for Refugee Health and Human Rights 617-414-4794 Boston Chinatown Neighborhood Cente 617-635-5129 2019 DMH MULTICU",38 Ash Street,Boston,MA,02111,617-287-0096,https://afab-kafanm.org,dual_diagnosis,,adolescent|adult,immigrant_refugee|lgbtq|woman,,,,asl|cantonese|english|haitian_creole|mandarin|multilingual_interpretation|vietnamese,Metro Boston,DMH Multicultural Directory 2019
+"Boston Children’s Hospital Department Psychiatry and-services/department- psychiatry Boston GLASS For LGBTQ+ youth, homel youth, and youth living wi HIV ages 13-29 857-399-1920 housing/health/boston-gl Boston Mayor’s Heal Line floor 800-847-0710 health-line Boston Medical Cente Immigrant & Refuge Program 617-414-5951 2019 DMH MULTICU",725 Albany Street,Boston,MA,02118,617-355-6680,https://childrenshospital.org/cent,dual_diagnosis,,adolescent,accessibility|immigrant_refugee|lgbtq|woman,,outpatient|residential,,cape_verdean_creole|english|haitian_creole|multilingual_interpretation|portuguese|spanish,Metro Boston,DMH Multicultural Directory 2019
+"Brazilian Immigran Center Brazilian Women’s Group 617-202-5775 Casa Esperanza 617-445-1123 Casa Myrna Vazquez, I 617-521-0100 Domestic Violence Hotlin 877-785-2020 2019 DMH MULTICU",P.O. Box 180019,Boston,MA,02118,617-783-8001,https://braziliancenter.org,dual_diagnosis,,adolescent,woman,,residential,,english|portuguese|spanish,Metro Boston,DMH Multicultural Directory 2019
+"Center Club, a progra of Bay Cove Human Services 617-788-1091 (Spanish) Center for Cross-Cultu Student Emotional Wellness 617-726-2000 ervices/ccsew_home.asp Children’s Services o Roxbury Specializes in serving the African-American populatio Greater Boston 617-445-6655 2019 DMH MULTICU",504 Dudley Street,Roxbury,MA,02119,617-788-1000,https://centerclubboston.org,dual_diagnosis,,adolescent|adult|young_adult,,,outpatient,,cantonese|cape_verdean_creole|english|haitian_creole|mandarin|spanish,Metro Boston,DMH Multicultural Directory 2019
+"Community Legal Services and Counseli Center Deaf and Hard of Hearing Service, Cambridge Health Alliance 617-665-3458 Dorchester House Hea Multi-Service Cente 617-740-2212 Emerge: Counseling a Education to Stop Domestic Violence Suite 101 617-547-9879 2019 DMH MULTICU",2464 Massachusetts Avenu,Cambridge,MA,02140,617-661-1010,https://clsacc.org,dual_diagnosis,,,accessibility|immigrant_refugee,,,,asl|english|french|spanish|vietnamese,Metro Boston,DMH Multicultural Directory 2019
+Eritrean Community Center Ethiopian Communit Mutual Assistance Association 617-492-4232 Fenway Health Healthcare for the LGBTQ community 617-267-0900 617-247-7555 617-457-8140 2019 DMH MULTICU,75 Kneeland Street,Boston,MA,02111,617-427-1210,https://eccboston.org,dual_diagnosis,,adult,lgbtq,,outpatient,,english|spanish,Metro Boston,DMH Multicultural Directory 2019
+Freedom Trail Clinic Deaf and Hard of Hearing Outpatient Mental Health lt-services/deaf-and-hard- hearing-outpatient-clinic services Frosina Information Network Albanian Cultural Resource Information Center 617-482-2002 Guidance Center 617-354-2275 2019 DMH MULTICU,5 Sacramento Street,Cambridge,MA,02138,617-912-7800,https://northsuffolk.org/services/,mental_health,,adolescent,accessibility,,outpatient,,asl|cantonese|english|haitian_creole|mandarin|portuguese|spanish,Metro Boston,DMH Multicultural Directory 2019
+Haitian American Pub Health Initiative 1601-1603 Blue Hill Avenu Haitian Mental Healt Network Email:HMHnetwork@gmail.c Harvard Program in Refugee Trauma 617-876-7879 Home for Little Wanderers 617-267-3700 Multiple sites in Boston ar 2019 DMH MULTICUL,10 Guest Street,Boston,MA,02135,617-298-8076,https://haphi.org,mental_health,,adolescent,immigrant_refugee,,residential,,english|french|haitian_creole|mandarin|spanish,Metro Boston,DMH Multicultural Directory 2019
+Inquilinos Boricuas E Accion Irish International Immigrant Center 617-542-7654 Irish Pastoral Cente 617-265-5300 Italian Home for Children 617-787-1901 2019 DMH MULTICUL,77 Warren Street,Brighton,MA,01235,617-927-1707,https://iba-etc.org,dual_diagnosis,alcohol,adolescent,immigrant_refugee,,,,english|french|haitian_creole|spanish,Metro Boston,DMH Multicultural Directory 2019
+"Kit Clark Senior Servi La Alianza Hispana, In 617-427-7175 Latino Health Insuran Program Iglesia Cristiana Nueva Vid 617-567-0235 Ext. 2 Massachusetts Alliance Portuguese Speaker 617-864-7600 Locations in Somerville, Brighton, and Dorchester 2019 DMH MULTICUL",1046 Cambridge Street,Cambridge,MA,02139,617-788-1083,https://kitclark.org,dual_diagnosis,,adolescent|older_adult,immigrant_refugee,,outpatient,,english|haitian_creole|portuguese|spanish|vietnamese,Metro Boston,DMH Multicultural Directory 2019
+"Massachusetts Societ for the Prevention o Cruelty to Children Native American Lifelines of Boston 857-203-9680 nativeamericanlifelines.o North American India Center of Boston, Inc 617-232-0343 North Suffolk Menta Health Association, In 617-889-3300 Locations in East Boston a Revere 2019 DMH MULTICUL",301 Broadway Street,Chelsea,MA,02128,617-983-5800,https://mspcc.org,dual_diagnosis,,adolescent|adult|older_adult,,,outpatient,,asl|cantonese|english|haitian_creole|khmer|mandarin|portuguese|spanish|vietnamese,Metro Boston,DMH Multicultural Directory 2019
+"Osiris Family Institu Priority Professiona Care 857-598-4774 Pyramid Builders Counseling Services, I 857-267-2059 Refugee and Immigra Assistance Center 617-238-2430 2019 DMH MULTICUL",31 Heath Street,Jamaica Plain,MA,02130,617-442-2002,https://osirisinstitute.com,dual_diagnosis,,adolescent,immigrant_refugee,,,,arabic|cape_verdean_creole|english|french|haitian_creole|portuguese|somali|spanish,Metro Boston,DMH Multicultural Directory 2019
+"Roca, Inc. Roxbury Multi-Servic Center 617-989-0292 Somali Developmen Center 10 Malcolm X Blvd. 2nd Flo 617-522-0700 South Bay Communi Service, Dorchester Mental Health Clinic 857-217-3700 southbaycommunityservices. 2019 DMH MULTICUL","415 Neponset Avenue, 3rd Fl",Dorchester,MA,02122,617-889-5210,https://rocainc.org,dual_diagnosis,,adolescent|adult,,,,,arabic|asl|cantonese|english|haitian_creole|mandarin|portuguese|somali|spanish|vietnamese,Metro Boston,DMH Multicultural Directory 2019
+Trauma Center Ummah Health 617-858-6114 Vietnamese America Civic Association 617-288-7344 Vietnamese America Initiative for Development 617-822-3717 Women’s Center 617-354-6394 cambridgewomenscenter. 2019 DMH MULTICUL,46 Pleasant Street,Cambridge,MA,02139,617-232-1303,https://traumacenter.org,mental_health,alcohol,adolescent|adult|young_adult,woman,,outpatient,,arabic|english|spanish|vietnamese,Metro Boston,DMH Multicultural Directory 2019
+"Advocates, Inc. and Advo Deaf Services Video Phone: 774-999-06 Email: DeafInquiries@Advoca African Children Educa 508-799-3653 ARISE (Advocacy for Re and Immigrant Service Empowerment) 617-446-3706 Ascentria Care Allian 774-243-3100 2019 DMH MULTICUL",11 Shattuck Street,Worcester,MA,01605,508-628-6300,https://advocates.org,mental_health,,adolescent,accessibility|immigrant_refugee,,outpatient|residential,,arabic|asl|english|haitian_creole|nepali|somali,Central MA,DMH Multicultural Directory 2019
+"Boston Health Care Callahan Center 508-532-5980 Center for Health Imp 508-756-6676 centerforhealthimpact. Center for Living an Working, Inc.: Deaf and of Hearing Independ Living Services Denholm Building, Suite 3 Voice: 508-798-0350 Video Phone: 508-762-11 2019 DMH MULTICUL",484 Main Street,Worcester,MA,01608,508-660-7974,https://bostonhealthcareinc.co,dual_diagnosis,,adolescent|adult|older_adult,accessibility,,,,arabic|asl|english|spanish|urdu,Central MA,DMH Multicultural Directory 2019
+"Centro Las America Children’s Friend 508-753-5425 s-friend Community Healthlink 508-791-3261 communityhealthlink.o Counseling and Assessm Clinic of Worcester, L 508-756-5400 978-345-9400 2019 DMH MULTICUL","33 Electric Avenue, Suite 2",Fitchburg,MA,01420,508-798-1900,https://centroinc.org,dual_diagnosis,,adolescent|adult,,,outpatient,,arabic|english|french|haitian_creole|italian|portuguese|spanish|thai|vietnamese,Central MA,DMH Multicultural Directory 2019
+Everyday Miracles everydaymiraclesprsc. Family Continuity Prog (FCP) 508-755-0556 508-234-4181 Friendly House 508-755-4362 2019 DMH MULTICUL,36 Wall Street,Worcester,MA,01604,508-799-6227,https://familycontinuity.org,mental_health,,,homeless,,outpatient,,arabic|english|nepali|somali|spanish,Central MA,DMH Multicultural Directory 2019
+"Hearing Loss Associati Central Massachuset Headquarters address: Bethesda, MD 20814 Meetings at Northborough Li Northborough, MA 0153 Email: info@hearinglosscentra .com Hector Reyes Hous Latin American Heal Alliance 508-459-1801 Jewish Community Ce 508-756-7109 2019 DMH MULTICUL",633 Salisbury Street,Worcester,MA,01609,301-657-2248,https://hearinglosscentralma.wor,dual_diagnosis,alcohol,adolescent|older_adult,,,residential,,asl|english|portuguese|spanish,Central MA,DMH Multicultural Directory 2019
+"Kiva Center Latino Health Insura Program 508-875-1237 Locations in Milford and Wor Learning Center for the Framingham, MA 0170 508-879-5110 Video Phone: 774-999-09 LUK Crisis Center 978-345-0685 508-640-0011 508-672-3000 2019 DMH MULTICUL",40 Southbridge Street,Worcester,MA,01608,508-751-9600,https://centralmassrlc.org,dual_diagnosis,,adolescent|adult|young_adult,accessibility,,residential,,asl|english|portuguese|spanish,Central MA,DMH Multicultural Directory 2019
+"Martin Luther King J Opportunity Center, SM Multicultural Wellness C 508-752-4665 978-343-3336 multiculturalwellness. Our Deaf Survivors Ce 978-451-7225 Email: CBosdc414@gmail. 2019 DMH MULTICUL",12 Meade Street,Worcester,MA,01610,508-756-6330,https://mlkj-oc.org,dual_diagnosis,,,accessibility|homeless,,outpatient,,arabic|asl|bengali|cape_verdean_creole|english|french|haitian_creole|hindi|japanese|portuguese|punjabi|russian|spanish,Central MA,DMH Multicultural Directory 2019
+Pathways for Change: Survivors Program Video Phone: 508-502-76 ncy-programs/deaf-survi program Refugee & Immigran Assistance Center Riverside Community 781-329-0909 2019 DMH MULTICUL,"270 Bridge Street, Suite 3",Dedham,MA,02026,508-756-7557,https://pathwaysforchange.help/p,mental_health,,adolescent,accessibility|immigrant_refugee,,outpatient,,arabic|asl|cantonese|english|french|korean|mandarin|portuguese|russian|somali|spanish,Central MA,DMH Multicultural Directory 2019
+Sarah Care /Adult Day H SMOC Behavioral Hea Services 508-872-4853 508-460-9699 Southeast Asian Coaliti Central Massachuset 508-791-4373 2019 DMH MULTICULT,"484 Main Street, Suite 40",Worcester,MA,01608,508-756-7272,https://sarahcare.com/Worces,dual_diagnosis,,adolescent|adult|young_adult,immigrant_refugee|woman,,residential,,english|khmer|lao|mandarin|portuguese|spanish|thai|vietnamese,Central MA,DMH Multicultural Directory 2019
+"Spanish American Cen spanishamericancenter UMass Memorial Health Behavioral/Psychiat Services 508-334-1000 Other locations in Worces umassmemorialhealthcar United Hmong of Massachusetts, Inc 978-343-3831 2019 DMH MULTICULT","21 Culley Street, Suite 10",Fitchburg,MA,01420,978-534-3145,https://unitedhmong.org,dual_diagnosis,,older_adult,homeless|woman,,outpatient|residential,,asl|english|spanish,Central MA,DMH Multicultural Directory 2019
+Worcester Adult Day He Renaissance daycare/worcester_ma_ci l Youth Opportunities Up Inc. 508-849-5600 Zia Access Center At The Bridge of Central M 508-751-9600 At the Kiva Center 774-242-6364 2019 DMH MULTICULT,209 Shrewsbury Street,Worcester,MA,01602,508-831-7500,https://daycarein.com/adult,dual_diagnosis,,adolescent|adult|young_adult,lgbtq,,intensive_outpatient|outpatient|residential,,asl|english|portuguese|russian|spanish,Central MA,DMH Multicultural Directory 2019
+"Alternative House, In Arbour Counseling Services 978-373-7010 978-686-8202 978-453-5736 Arbour Counseling Services Latino Program 617-855-2000 /Latino-services 2019 DMH MULTICULTURA",115 Mill Street,Belmont,MA,02478,978-937-5777,https://alternative-house.org,dual_diagnosis,,adult,lgbtq|woman,,,,english|khmer|portuguese|russian|spanish,Northeast,DMH Multicultural Directory 2019
+"Bosnian Community Center for Resource Development, Inc. Cambodian Mutual Assistance Associatio 978-454-6200 Children’s Friend & Family Services—A Division of Justice Research Institute 781-592-5691 978-682-7289 2019 DMH MULTICULTURA",15 Union Street,Lawrence,MA,01840,781-593-0100,https://bccrd.org,mental_health,,adolescent,accessibility|immigrant_refugee,,outpatient,,arabic|cantonese|english|haitian_creole|hindi|khmer|lao|mandarin|nepali|somali|spanish|thai|vietnamese,Northeast,DMH Multicultural Directory 2019
+Congolese Development Center Eliot Community Human Services 781-395-0704 Family Continuity Programs (FCP) 978-687-1617 978-927-9410 2019 DMH MULTICULTURA,"9 Centennial Drive, Suite 20",Peabody,MA,01960,781-593-0100,https://cd-c.org,dual_diagnosis,,adolescent,,,outpatient,,english|french|haitian_creole|mandarin|portuguese|spanish,Northeast,DMH Multicultural Directory 2019
+International Institut of Lowell Jewish Family and Children’s Services 781-647-5327 Lahey/Northeast Behavioral Health 978-374-0414 978-922-0025 2019 DMH MULTICULTURA,298 Washington Street,Gloucester,MA,01930,978-459-9031,https://iine.org,dual_diagnosis,,adolescent|adult,immigrant_refugee,,intensive_outpatient|outpatient|residential,,english|french|haitian_creole|hebrew|japanese|russian|spanish,Northeast,DMH Multicultural Directory 2019
+Lowell Community Health Metta Health Center Massachusetts Allianc of Portuguese Speake (MAPS) 978-970-1250 2019 DMH MULTICULTURA,11 Mill Street,Lowell,MA,01852,978-441-1700,https://lchealth.org,mental_health,,older_adult,immigrant_refugee,,,,english|french|hindi|khmer|lao|mandarin|portuguese|vietnamese,Northeast,DMH Multicultural Directory 2019
+McLean Hospital Mystic Valley Elder Services 781-324-7705 Northeast Independe Living Program 978-687-4288 2019 DMH MULTICULTURA,20 Ballard Road,Lawrence,MA,01843,800-333-0338,https://mcleanhospital.org,mental_health,alcohol,adolescent|adult|older_adult,accessibility|lgbtq,,outpatient|residential,,asl|english|french|haitian_creole|russian|spanish,Northeast,DMH Multicultural Directory 2019
+Refugee & Immigran Assistance Center (RIAC) Russian Community Association of Massachusetts 781-593-0100 South Bay Communit Services 978-542-1951 978-674-5400 Other locations in Lawrenc and Malden southbaycommunityser 2019 DMH MULTICULTURA,22 Old Canal Drive,Lowell,MA,01851,781-593-0100,https://riacboston.org,dual_diagnosis,,adolescent|adult|older_adult,immigrant_refugee,,,,arabic|english|japanese|khmer|portuguese|russian|somali|spanish,Northeast,DMH Multicultural Directory 2019
+Wayside Youth & Family Support Network YouForward 978-989-2047 Drop-in Centers: Mondays through Wednesdays 1:00-6:00pm YouForward-Entrance B i the back of the building Thursdays 2:00-5:00pm Haverhill YMCA 2019 DMH MULTICULTURA,81 Winter Street,Haverhill,MA,01830,978-460-8712,https://waysideyouth.org,mental_health,,adolescent|adult|young_adult,lgbtq,,outpatient,,english|khmer|portuguese|spanish,Northeast,DMH Multicultural Directory 2019
+"Abelard Psychothera LLC Arbour Counseling Center West Yarmouth, MA 026 774-470-2294 508-678-2833 BAMSI (Brockton Ar Multi-Services, Inc. 508-580-8700",24 Mercedes Road,Brockton,MA,02301,781-344-0057,https://abelardpsychotherapy.co,dual_diagnosis,,adolescent|adult,,,intensive_outpatient|outpatient,,cape_verdean_creole|english|haitian_creole|portuguese|spanish,Southeast,DMH Multicultural Directory 2019
+"Boston Chinatown Neighborhood Cente 617-770-0091 Bristol Elder Service 1 Father Devalles Blvd, # 508-675-2101 Cape Cod Behaviora Health Services Psychiatric Center 508-862-5566",27 Park Street,Hyannis,MA,02601,617-635-5129,https://bcnc.net,mental_health,,adolescent|adult|older_adult,,,outpatient|residential,,asl|cantonese|english|khmer|mandarin|portuguese|spanish|vietnamese,Southeast,DMH Multicultural Directory 2019
+Catholic Charities Child & Family Servic 508-990-0894 508-996-8572 508-996-3154,543 North Street,New Bedford,MA,02740,508-587-0815,https://ccab.org,mental_health,,adolescent,immigrant_refugee,,,,cape_verdean_creole|english|french|haitian_creole|portuguese|spanish,Southeast,DMH Multicultural Directory 2019
+"Community Counseli of Bristol County 508-823-6124 508-222-8812 Fairwinds-Nantucke Counseling Center 20 Vesper Lane, #L1 508-228-2689",5 Bank Street,Nantucket,MA,02554,508-828-9116,https://comcounseling.org,dual_diagnosis,,adolescent|adult,,,outpatient,,asl|english|korean|portuguese|spanish,Southeast,DMH Multicultural Directory 2019
+"Family Continuity Program (FCP) 29 Bassett lane 508-862-0273 Family Service Association 508-677-3822 Health Imperatives 508-583-3005 Other locations in Falmou Vineyard Haven, Nantuck Plymouth, and New Bedfo",942 West Chestnut Stre,Brockton,MA,02301,508-747-6762,https://familycontinuity.org,mental_health,,adolescent|adult,lgbtq,,outpatient,,cape_verdean_creole|english|khmer|portuguese|spanish,Southeast,DMH Multicultural Directory 2019
+High Point Treatme Center Immigrants Assistan Center 508-996-8113 immigrantsassistancecenter Independence Hous Inc. 160 Bassett Lane 508-771-6507,58 Crapo Street,Hyannis,MA,02601,508-224-7701,https://hptc.org,dual_diagnosis,,adolescent,immigrant_refugee|woman,,outpatient,,english|portuguese|spanish,Southeast,DMH Multicultural Directory 2019
+"Italian Home for Children 5 Palmer Court East Freetown, MA 0271 Luminosity Behavior Health 781-344-0102 Martha’s Vineyard Community Service 508-693-7900",111 Edgartown Road,Oak Bluffs,MA,02557,508-763-4217,https://italianhome.org,dual_diagnosis,,adolescent,veteran,,,,asl|cape_verdean_creole|english|french|haitian_creole|portuguese|spanish,Southeast,DMH Multicultural Directory 2019
+New Life Counselin 400-402 North Main Stre newlifecounselingcenter. Northeast Family Services 774-206-1125 northeastfamilyservices.c Pyramid Builders Counseling 617-481-8566 pyramidbuilderscounseling.,425 Pleasant street,Brockton,MA,02301,781-986-4800,,mental_health,,,,,outpatient,,cantonese|cape_verdean_creole|english|haitian_creole|mandarin|spanish,Southeast,DMH Multicultural Directory 2019
+"Seven Hills Behavior Health New Bedford, MA 0274 South Shore Menta Health 617-847-1950 St. Vincent’s Home 508-679-8511",2425 Highland Avenue,Fall River,MA,02720,508-995-6360,https://sevenhills.org,dual_diagnosis,,adolescent|adult,,,intensive_outpatient|outpatient|residential,,asl|cantonese|cape_verdean_creole|english|french|haitian_creole|mandarin|portuguese|spanish|vietnamese,Southeast,DMH Multicultural Directory 2019
+The Women’s Cente (Greater New Bedfo Women’s Center),405 County Street,New Bedford,MA,02740,508-996-3343,https://thewomenscenters.com,mental_health,,adolescent,woman,,residential,,english|portuguese|spanish,Southeast,DMH Multicultural Directory 2019
+"A Positive Place Northampton, MA 0106 ms-services/hivaids AdCare West Springfield, MA 010 413-209-3124 AdLib 413-442-7047 2019 DMH MUL",215 North Street,Pittsfield,MA,01201,413-586-8288,https://cooleydickinson.org/pr,mental_health,,,accessibility|lgbtq|woman,,outpatient,,asl|english,Western MA,DMH Multicultural Directory 2019
+"Anchor House Northampton, MA 0106 anchorhouseartists.o Ascentria Service for N Americans 413-787-0725 services/services-new americans Behavioral Health Network 413-747-0705 Other locations in Westfie Ware, Greenfield, and Holy 2019 DMH MUL",417 Liberty Street,Springfield,MA,01104,413-588-4337,https://ascentria.org/our-,dual_diagnosis,,adolescent,immigrant_refugee|lgbtq,,,,english|italian|russian|spanish,Western MA,DMH Multicultural Directory 2019
+"Berkshire Immigran Center Brick House Commun Resource Center Turners Falls, MA 0137 413-863-9576 brickhousecommunity. Brien Center 413-499-0412 2019 DMH MUL",333 East Street,Pittsfield,MA,01201,413-445-4881,https://berkshireic.com,mental_health,,adolescent|adult,immigrant_refugee,,outpatient,,asl|english|russian|spanish,Western MA,DMH Multicultural Directory 2019
+"Casa Latina Catholic Charities, Diocese of Springfie 413-452-0605 es/cca Center for Human Development 413-733-6624 Center for New Americans Northampton, MA 0106 413-587-0084 2019 DMH MUL",42 Gothic Street,Springfield,MA,01107,413-586-1569,https://casalatinainc.org,mental_health,,adolescent|older_adult,accessibility|immigrant_refugee|lgbtq,,,,english|mandarin|russian|spanish|urdu|vietnamese,Western MA,DMH Multicultural Directory 2019
+"ORGANIZATIONS Center for Women a Community Clinical & Support Options Northampton, MA 0106 413-773-1314 Other locations include Greenfield, Pittsfield, Spring Athol, Amherst, Florenc Orange, and Gardner Community Action 413-774-2318 Northampton, MA 0106 413-582-4230 978-544-5423 2019 DMH MUL",167 South Main Street,Orange,MA,01364,413-545-0883,https://umass.edu/cwc,mental_health,,adolescent|adult,lgbtq|woman,,outpatient,,english|nepali|russian|spanish,Western MA,DMH Multicultural Directory 2019
+ORGANIZATIONS DIAL/SELF Youth an Community Service Elizabeth Freeman Ce 413-499-2425 elizabethfreemancenter Fair Housing Cente 413-539-9796 2019 DMH MUL,57 Suffolk Street,Holyoke,MA,01040,413-774-7054,https://dialself.org,mental_health,,adolescent|adult|young_adult,homeless|immigrant_refugee|lgbtq,,,,english|spanish,Western MA,DMH Multicultural Directory 2019
+"Franklin County Lif Path Gandara Center West Springfield, MA 010 413-736-8329 Guidewire Inc. 413-733-6100 413-443-3295 2019 DMH MUL",34 Depot Street,Pittsfield,MA,01201,413-773-5555,https://lifepathma.org,dual_diagnosis,,adolescent|adult|older_adult|young_adult,accessibility|lgbtq,,intensive_outpatient|residential,,asl|english|spanish,Western MA,DMH Multicultural Directory 2019
+"Impact Center Springfield, MA youth-access-center Jewish Family Servic Western Massachuse 413-737-2601 2019 DMH MUL",15 Lenox Street,Springfield,MA,01108,413-654-1566,https://gandaracenter.org/imp,dual_diagnosis,,adolescent,immigrant_refugee,,,,arabic|english|french|nepali|somali|spanish|vietnamese,Western MA,DMH Multicultural Directory 2019
+Martin Luther King J Family Services Massachusetts Society the Prevention of Cru to Children 413-532-9446 Mental Health Association 413-734-5376 2019 DMH MULT,995 Worthington Stree,Springfield,MA,01109,413-746-3655,https://mlkjrfamilyservices.org,mental_health,,adolescent|adult|young_adult,accessibility|homeless,,residential,,english|spanish,Western MA,DMH Multicultural Directory 2019
+"Montague Catholic So Ministries Turners Falls, MA 0137 New England Learni Center for Women i Transition 413-772-0871 Northeast Center fo Youth and Familie Easthampton, MA 0102 800-360-6210 2019 DMH MULT",203 East Street,Greenfield,MA,01301,413-863-4804,https://mcsmcommunity.or,mental_health,,adolescent,woman,,intensive_outpatient|outpatient|residential,,english|spanish,Western MA,DMH Multicultural Directory 2019
+"Northeast Family Serv West Springfield, MA 010 northeastfamilyservices Nuestras Raices, In 413-535-1789 Picknelly Adult an Family Education Cen 413-552-2990 progams/adult-basic education/picknelly-ad and-family-educatin-ce Roca Inc. 413-846-4301 2019 DMH MULT",29 School Street,Springfield,MA,01105,774-206-1125,https://nuestras-raices.org,mental_health,,adolescent|adult,,,outpatient,,english|spanish,Western MA,DMH Multicultural Directory 2019
+"Safe Passage Northampton, MA 0106 ServiceNet Northampton, MA 0106 413-585-1300 Springfield Vietnam Cultural Center 413-733-9373 2019 DMH MULT",433 Belmont Avenue,Springfield,MA,01108,413-586-1125,https://safepass.org,dual_diagnosis,,adolescent|adult|older_adult|young_adult,accessibility|immigrant_refugee|lgbtq,,residential,,english|khmer|spanish|vietnamese,Western MA,DMH Multicultural Directory 2019
+"Stavros Tapestry Health 413-586-2016 Other locations includ Greenfield, Holyoke, No Adams, Northampton, Pitts Springfield, and West Sprin Valley Opportunit Council 413-552-1554 413-552-1554 2019 DMH MULT",300 High Street,Holyoke,MA,01040,413-256-0473,https://stavros.org,mental_health,,adolescent|adult|older_adult|young_adult,accessibility|lgbtq,,,,arabic|asl|english|french|russian|spanish,Western MA,DMH Multicultural Directory 2019
+"Viability, Inc. Walden Community Serv Learning Center for the Phone and TTY: 508-879-5 Video Phone: 774-999-094 Western Mass Recove Learning Communit 413-539-5941 413-372-5652 413-772-0715 Afiya (Peer-run respite hou Northampton, MA 2019 DMH MULT",74 Federal Street,Greenfield,MA,01301,413-584-1460,https://viability.org,mental_health,,adolescent|young_adult,accessibility,,,,asl|english|spanish,Western MA,DMH Multicultural Directory 2019
+services (/how-to/apply-for-dmh-services),,,MA,,(413) 587-6200,https://www.mass.gov/how-to/apply-for-dmh-,mental_health,,young_adult,,,,,english,Western MA,Western Mass Young Adult Guide
+training and presentation programs for community members.,,A Springfield Street Agawam,MA,01001,413-786-9139,https://namimass.org/support-and-,mental_health,,adolescent|young_adult,,,,,english,Western MA,Western Mass Young Adult Guide
+"21 Olander Dr., Northampton, MA 01060","235 Chestnut St,",Springfield,MA,01103,(413) 585-1300,https://www.servicenet.org/services/child-and-adolescent-services/prevention-recovery-early-psychosis-prep-2/,mental_health,,adolescent|young_adult,,,,,english,Western MA,Western Mass Young Adult Guide
+"Bowen Resource & Wellness Center, 235 Chestnut St, Springfield, MA","235 Chestnut St,",Springfield,MA,01103,(413) 372-5652,https://wildfloweralliance.org,mental_health,,adolescent|young_adult,,,,,english,Western MA,Western Mass Young Adult Guide
+772-0715,"235 Chestnut St,",Springfield,MA,01103,866-641-2853,https://wildfloweralliance.org,mental_health,,adolescent|adult|young_adult,,,,,english,Western MA,Western Mass Young Adult Guide
+Central Intake,,Boston,MA,02108,(413) 737-2439,https://www.mass.gov/childrens-,dual_diagnosis,,adolescent|young_adult,,,,,english,Western MA,Western Mass Young Adult Guide
+Department of Mental Health and the Department of Public Health.,"41 Taylor Street,",Springfield,MA,01103,(413) 654-1566,https://www.springfieldimpactcenter.org/,mental_health,,adolescent|adult|young_adult,,,,,english,Western MA,Western Mass Young Adult Guide
+sufficiency for themselves and their families.,,,MA,,(413) 552-1554,https://www.valleyopp.com/about-voc/our-,mental_health,,young_adult,,,,,english,Western MA,Western Mass Young Adult Guide

requirements.txt

@@ -0,0 +1,176 @@
+accelerate==1.13.0
+aiofiles==24.1.0
+aiohappyeyeballs==2.6.1
+aiohttp==3.13.3
+aiosignal==1.4.0
+annotated-doc==0.0.4
+annotated-types==0.7.0
+anyio==4.12.1
+appnope==0.1.4
+argon2-cffi==25.1.0
+argon2-cffi-bindings==25.1.0
+arrow==1.4.0
+asttokens==3.0.1
+async-lru==2.2.0
+attrs==25.4.0
+babel==2.18.0
+beautifulsoup4==4.14.3
+bitsandbytes==0.49.2
+bleach==6.3.0
+brotli==1.2.0
+certifi==2026.2.25
+cffi==2.0.0
+charset-normalizer==3.4.5
+click==8.3.1
+comm==0.2.3
+cut-cross-entropy==25.1.1
+datasets==4.3.0
+debugpy==1.8.20
+decorator==5.2.1
+defusedxml==0.7.1
+diffusers==0.37.0
+dill==0.4.0
+docstring_parser==0.17.0
+executing==2.2.1
+fastapi==0.135.1
+fastjsonschema==2.21.2
+ffmpy==1.0.0
+filelock==3.25.1
+fqdn==1.5.1
+frozenlist==1.8.0
+fsspec==2025.9.0
+git-filter-repo==2.47.0
+gradio==6.9.0
+gradio_client==2.3.0
+groovy==0.1.2
+h11==0.16.0
+hf-xet==1.4.2
+hf_transfer==0.1.9
+httpcore==1.0.9
+httpx==0.28.1
+huggingface_hub==1.7.1
+idna==3.11
+importlib_metadata==8.7.1
+ipykernel==7.2.0
+ipython==9.11.0
+ipython_pygments_lexers==1.1.1
+ipywidgets==8.1.8
+isoduration==20.11.0
+jedi==0.19.2
+Jinja2==3.1.6
+json5==0.13.0
+jsonpointer==3.0.0
+jsonschema==4.26.0
+jsonschema-specifications==2025.9.1
+jupyter==1.1.1
+jupyter-console==6.6.3
+jupyter-events==0.12.0
+jupyter-lsp==2.3.0
+jupyter_client==8.8.0
+jupyter_core==5.9.1
+jupyter_server==2.17.0
+jupyter_server_terminals==0.5.4
+jupyterlab==4.5.6
+jupyterlab_pygments==0.3.0
+jupyterlab_server==2.28.0
+jupyterlab_widgets==3.0.16
+lark==1.3.1
+markdown-it-py==4.0.0
+MarkupSafe==3.0.3
+matplotlib-inline==0.2.1
+mdurl==0.1.2
+mistune==3.2.0
+mpmath==1.3.0
+msgspec==0.20.0
+multidict==6.7.1
+multiprocess==0.70.16
+nbclient==0.10.4
+nbconvert==7.17.0
+nbformat==5.10.4
+nest-asyncio==1.6.0
+networkx==3.6.1
+notebook==7.5.5
+notebook_shim==0.2.4
+numpy==1.26.4
+orjson==3.11.7
+packaging==26.0
+pandas==3.0.1
+pandocfilters==1.5.1
+parso==0.8.6
+peft==0.18.1
+pexpect==4.9.0
+pillow==12.1.1
+platformdirs==4.9.4
+prometheus_client==0.24.1
+prompt_toolkit==3.0.52
+propcache==0.4.1
+protobuf==7.34.0
+psutil==7.2.2
+ptyprocess==0.7.0
+pure_eval==0.2.3
+pyarrow==23.0.1
+pycparser==3.0
+pydantic==2.12.5
+pydantic_core==2.41.5
+pydub==0.25.1
+Pygments==2.19.2
+python-dateutil==2.9.0.post0
+python-dotenv==1.2.2
+python-json-logger==4.0.0
+python-multipart==0.0.22
+pytz==2026.1.post1
+PyYAML==6.0.3
+pyzmq==27.1.0
+referencing==0.37.0
+regex==2026.2.28
+requests==2.32.5
+rfc3339-validator==0.1.4
+rfc3986-validator==0.1.1
+rfc3987-syntax==1.1.0
+rich==14.3.3
+rpds-py==0.30.0
+safehttpx==0.1.7
+safetensors==0.7.0
+semantic-version==2.10.0
+Send2Trash==2.1.0
+sentencepiece==0.2.1
+setuptools==82.0.1
+shellingham==1.5.4
+six==1.17.0
+soupsieve==2.8.3
+stack-data==0.6.3
+starlette==0.52.1
+sympy==1.14.0
+terminado==0.18.1
+tinycss2==1.4.0
+tokenizers==0.22.2
+tomlkit==0.13.3
+torch==2.10.0
+torchao==0.16.0
+torchvision==0.25.0
+tornado==6.5.5
+tqdm==4.67.3
+traitlets==5.14.3
+transformers==5.2.0
+trl==0.24.0
+typeguard==4.5.1
+typer==0.24.1
+typer-slim==0.24.0
+typing-inspection==0.4.2
+typing_extensions==4.15.0
+tyro==1.0.8
+tzdata==2025.3
+unsloth==2026.3.4
+unsloth_zoo==2026.3.2
+uri-template==1.3.0
+urllib3==2.6.3
+uvicorn==0.41.0
+wcwidth==0.6.0
+webcolors==25.10.0
+webencodings==0.5.1
+websocket-client==1.9.0
+wheel==0.46.3
+widgetsnbextension==4.0.15
+xxhash==3.6.0
+yarl==1.23.0
+zipp==3.23.0

src/__init__.py

@@ -0,0 +1 @@
+

src/chat.py

@@ -0,0 +1,121 @@
+from huggingface_hub import InferenceClient
+from src.config import BASE_MODEL, MY_MODEL, HF_TOKEN
+import os
+from src.utils.profile import load_schema, create_empty_profile, extract_profile_updates, merge_profile, profile_to_summary
+from src.utils.resources import load_resources, filter_resources, score_resources, format_recommendations
+
+class Chatbot:
+
+    def __init__(self):
+        """
+        Initialize the chatbot with a HF model ID
+        """
+        model_id = MY_MODEL if MY_MODEL else BASE_MODEL # define MY_MODEL in config.py if you create a new model in the HuggingFace Hub
+        self.client = InferenceClient(model=model_id, token=HF_TOKEN)
+        # Initialize user profile
+        current_dir = os.path.dirname(os.path.abspath(__file__))
+        data_dir = os.path.join(current_dir, '..', 'data')
+        self.profile_schema = load_schema(os.path.join(data_dir, 'user_profile_schema.json'))
+        self.user_profile = create_empty_profile()
+        # Load treatment resources once
+        knowledge_dir = os.path.join(data_dir, '..', 'references', 'knowledge')
+        resources_paths = [
+            os.path.join(knowledge_dir, 'ma_resources.csv'),
+            os.path.join(knowledge_dir, 'boston_resources.csv'),
+        ]
+        self.resources = load_resources(resources_paths)
+
+    def update_profile(self, user_input):
+        """
+        Scan user input for profile-relevant information and merge it
+        into the running user profile.
+
+        Args:
+            user_input (str): The user's message text.
+        """
+        updates = extract_profile_updates(self.profile_schema, user_input)
+        merge_profile(self.user_profile, updates)
+
+    def format_prompt(self, user_input):
+        """
+        Format the user's input into a list of chat messages with system context.
+        Updates the user profile with any new information detected.
+
+        This method:
+        1. Loads system prompt from system_prompt.md
+        2. Updates user profile from schema-based keyword matching
+        3. Injects profile summary into the system prompt so the model knows what's been gathered
+        4. Returns a list of message dicts for the chat completion API
+
+        Args:
+            user_input (str): The user's question
+
+        Returns:
+            list[dict]: A list of message dicts with 'role' and 'content' keys
+        """
+        # Get the directory where this file is located
+        current_dir = os.path.dirname(os.path.abspath(__file__))
+
+        # Load system prompt
+        system_prompt_path = os.path.join(current_dir, '../data/system_prompt.md')
+        with open(system_prompt_path, 'r', encoding='utf-8') as f:
+            system_prompt = f.read().strip()
+
+        # Update user profile from this message
+        self.update_profile(user_input)
+
+        # Build profile summary for the prompt
+        profile_summary = profile_to_summary(self.user_profile)
+
+        # Build system message with profile context
+        system_content = system_prompt
+        if profile_summary:
+            system_content = system_content + "\n\n" + profile_summary
+
+        # Return structured messages for chat completion API
+        messages = [
+            {"role": "system", "content": system_content},
+            {"role": "user", "content": user_input},
+        ]
+
+        return messages
+        
+    def get_response(self, user_input):
+        """
+        Generate a response to the user's question, with resource recommendations
+        appended when the user profile contains enough information to match.
+
+        Args:
+            user_input (str): The user's question
+
+        Returns:
+            str: The chatbot's response, optionally followed by top 3 resources
+        """
+        # 1. Format messages (also updates profile)
+        messages = self.format_prompt(user_input)
+
+        # 2. Generate LLM response via chat completion API
+        result = self.client.chat_completion(
+            messages=messages,
+            max_tokens=512,
+            temperature=0.7,
+        )
+        response = result.choices[0].message.content.strip()
+
+        # 3. Filter resources by profile, score, and append top 3
+        filtered = filter_resources(self.resources, self.user_profile)
+        top_resources = score_resources(filtered, self.user_profile)
+        recommendations = format_recommendations(top_resources)
+
+        # Log recommendations to console
+        if top_resources:
+            print(f"[Harbor] Chat recommendations ({len(top_resources)}) for profile:")
+            for i, r in enumerate(top_resources, 1):
+                print(f"  {i}. {r.get('name', 'Unknown')} — {r.get('city', '')}, {r.get('state', '')} {r.get('zip', '')}")
+        else:
+            print("[Harbor] No recommendations matched current profile.")
+
+        if recommendations:
+            response = response + "\n\n" + recommendations
+
+        return response

src/config.py

@@ -0,0 +1,17 @@
+import os
+from dotenv import load_dotenv
+
+# Load from .env file. Store your HF token in the .env file.
+load_dotenv()
+
+
+BASE_MODEL = "Qwen/Qwen2.5-7B-Instruct"
+# Other options:
+# BASE_MODEL = "meta-llama/Llama-3.2-3B-Instruct"  # gated — requires Meta license approval
+# BASE_MODEL = "Qwen/Qwen2.5-1.5B-Instruct"        # ungated, smaller/faster
+# BASE_MODEL = "HuggingFaceH4/zephyr-7b-beta"       # ungated
+
+# If you finetune the model or change it in any way, save it to huggingface hub, then set MY_MODEL to your model ID. The model ID is in the format "your-username/your-model-name".
+MY_MODEL = "" #"amitashukla/harbor-qwn25-lora"
+
+HF_TOKEN = os.getenv("HF_TOKEN")

src/utils/__init__.py

@@ -0,0 +1,2 @@
+# Utils package for helper functions
+

src/utils/profile.py

@@ -0,0 +1,224 @@
+import json
+import re
+
+
+def load_schema(schema_path):
+    """Load the user profile schema from a JSON file."""
+    with open(schema_path, 'r', encoding='utf-8') as f:
+        return json.load(f)
+
+
+def create_empty_profile():
+    """
+    Create an empty user profile with all fields set to null/empty.
+    This represents a user we know nothing about yet.
+    """
+    return {
+        "demographics": {
+            "population": None,
+            "identity_factors": [],
+            "language": None,
+            "pronouns": None
+        },
+        "logistics": {
+            "zipcode": None,
+            "region": None,
+            "profession": None,
+            "accessibility_needs": [],
+            "insurance": None,
+            "treatment_history": None
+        },
+        "status": {
+            "current_state": None,
+            "crisis_level": None,
+            "temporary_factors": []
+        },
+        "clinical": {
+            "primary_focus": None,
+            "substances": []
+        },
+        "preferences": {
+            "setting": None,
+            "therapy_approach": None,
+            "scheduling": [],
+            "barriers": [],
+            "contact_channel": None
+        }
+    }
+
+
+def extract_profile_updates(schema, user_input):
+    """
+    Scan user input against the schema and return a dict of detected profile updates.
+
+    For 'single' type fields, returns the first matched option value.
+    For 'multi' type fields, returns a list of all matched option values.
+    For 'extracted' type fields (zipcode, region, treatment_history), uses
+    pattern matching or returns raw text snippets.
+
+    Args:
+        schema: The loaded profile schema dict.
+        user_input: The user's message text.
+
+    Returns:
+        dict: Nested dict mirroring the profile structure, containing only
+              fields where matches were found.
+    """
+    input_lower = user_input.lower()
+    updates = {}
+
+    for category_name, category in schema.items():
+        category_updates = {}
+
+        for field_name, field_def in category.items():
+            field_type = field_def.get("type")
+
+            if field_type == "extracted":
+                # Special handling for pattern-based or free-text fields
+                value = _extract_field(field_name, field_def, user_input, input_lower)
+                if value is not None:
+                    category_updates[field_name] = value
+
+            elif field_type in ("single", "multi"):
+                matches = []
+                for option in field_def.get("options", []):
+                    for keyword in option.get("keywords", []):
+                        if keyword and keyword.lower() in input_lower:
+                            matches.append(option["value"])
+                            break  # one keyword match per option is enough
+
+                if matches:
+                    if field_type == "single":
+                        category_updates[field_name] = matches[0]
+                    else:
+                        category_updates[field_name] = matches
+
+        if category_updates:
+            updates[category_name] = category_updates
+
+    return updates
+
+
+def _extract_field(field_name, field_def, user_input, input_lower):
+    """Handle extraction for non-option fields like zipcode and treatment_history."""
+    if field_name == "zipcode":
+        pattern = field_def.get("pattern", r"\b\d{5}\b")
+        match = re.search(pattern, user_input)
+        if match:
+            return match.group()
+        return None
+
+    if field_name == "region":
+        # Region is typically set explicitly or by the LLM, not keyword-matched.
+        # We do a lightweight check for common geographic indicators.
+        geo_patterns = [
+            r"\bin\s+([A-Z][a-z]+(?:\s+[A-Z][a-z]+)*)",  # "in Boston", "in Pocahontas County"
+            r"\bnear\s+([A-Z][a-z]+(?:\s+[A-Z][a-z]+)*)",  # "near Springfield"
+            r"\bfrom\s+([A-Z][a-z]+(?:\s+[A-Z][a-z]+)*)",  # "from Cambridge"
+        ]
+        for pattern in geo_patterns:
+            match = re.search(pattern, user_input)
+            if match:
+                return match.group(1)
+        return None
+
+    if field_name == "treatment_history":
+        history_keywords = ["rehab", "treatment before", "been to", "tried",
+                            "previous treatment", "went to", "was in",
+                            "12-step", "residential before", "relapsed"]
+        for keyword in history_keywords:
+            if keyword in input_lower:
+                return user_input  # store the raw message as context
+        return None
+
+    return None
+
+
+def merge_profile(profile, updates):
+    """
+    Merge new updates into the existing profile.
+
+    - For 'single' fields (non-list values): new values overwrite old ones.
+    - For 'multi' fields (list values): new values are appended (no duplicates).
+    - None values in updates are ignored (don't clear existing data).
+
+    Args:
+        profile: The current user profile dict (modified in place).
+        updates: The updates dict from extract_profile_updates().
+
+    Returns:
+        dict: The updated profile (same object as input).
+    """
+    for category_name, category_updates in updates.items():
+        if category_name not in profile:
+            continue
+
+        for field_name, new_value in category_updates.items():
+            if field_name not in profile[category_name]:
+                continue
+
+            if new_value is None:
+                continue
+
+            existing = profile[category_name][field_name]
+
+            if isinstance(existing, list) and isinstance(new_value, list):
+                # Append new values, skip duplicates
+                for v in new_value:
+                    if v not in existing:
+                        existing.append(v)
+            elif isinstance(existing, list) and not isinstance(new_value, list):
+                # Single value going into a list field
+                if new_value not in existing:
+                    existing.append(new_value)
+            else:
+                # Single value field: overwrite
+                profile[category_name][field_name] = new_value
+
+    return profile
+
+
+def profile_to_summary(profile):
+    """
+    Convert a user profile dict into a concise text summary for injection
+    into the system prompt. Only includes fields that have been filled in.
+
+    Returns:
+        str: A human-readable summary, or empty string if profile is empty.
+    """
+    lines = []
+
+    category_labels = {
+        "demographics": "Demographics",
+        "logistics": "Logistics & History",
+        "status": "Current Status",
+        "clinical": "Clinical Needs",
+        "preferences": "Preferences & Barriers"
+    }
+
+    for category_name, category_label in category_labels.items():
+        category = profile.get(category_name, {})
+        category_lines = []
+
+        for field_name, value in category.items():
+            if value is None:
+                continue
+            if isinstance(value, list) and len(value) == 0:
+                continue
+
+            # Format the field name nicely
+            display_name = field_name.replace("_", " ").title()
+
+            if isinstance(value, list):
+                category_lines.append(f"  - {display_name}: {', '.join(str(v) for v in value)}")
+            else:
+                category_lines.append(f"  - {display_name}: {value}")
+
+        if category_lines:
+            lines.append(f"[{category_label}]")
+            lines.extend(category_lines)
+
+    if not lines:
+        return ""
+
+    return "USER PROFILE (gathered so far):\n" + "\n".join(lines)

src/utils/resources.py

@@ -0,0 +1,240 @@
+import csv
+
+
+# Profile field → (csv_column, weight)
+FIELD_MAP = [
+    ("clinical",      "primary_focus",      "primary_focus",       3),
+    ("clinical",      "substances",         "substances",          3),
+    ("demographics",  "population",         "age_groups",          2),
+    ("demographics",  "identity_factors",   "identity_factors",    2),
+    ("logistics",     "insurance",          "insurance",           2),
+    ("preferences",   "setting",            "settings",            2),
+    ("preferences",   "therapy_approach",   "therapy_approaches",  1),
+    ("demographics",  "language",           "languages",           1),
+]
+
+
+def load_resources(csv_path):
+    """Load one or more resource CSVs into a list of dicts.
+
+    Accepts a single path (str) or a list of paths. Called once at init.
+    """
+    if isinstance(csv_path, str):
+        csv_path = [csv_path]
+    rows = []
+    for path in csv_path:
+        with open(path, "r", encoding="utf-8") as f:
+            reader = csv.DictReader(f)
+            rows.extend(reader)
+    return rows
+
+
+def _get_profile_value(profile, category, field):
+    """Safely get a profile value, returning None for missing/empty."""
+    val = profile.get(category, {}).get(field)
+    if val is None:
+        return None
+    if isinstance(val, list) and len(val) == 0:
+        return None
+    return val
+
+
+def _pipe_values(cell):
+    """Split a pipe-delimited CSV cell into a set of lowercase values."""
+    if not cell or not cell.strip():
+        return set()
+    return {v.strip().lower() for v in cell.split("|")}
+
+
+def filter_resources(resources, user_profile):
+    """
+    Filter the full resource list down to a relevant subset based on
+    user profile values. Applies geographic, primary_focus, and substances
+    filters. Progressively relaxes filters if fewer than 3 results remain.
+    """
+    zipcode = _get_profile_value(user_profile, "logistics", "zipcode")
+    region = _get_profile_value(user_profile, "logistics", "region")
+    primary_focus = _get_profile_value(user_profile, "clinical", "primary_focus")
+    substances = _get_profile_value(user_profile, "clinical", "substances")
+
+    # No profile info → no filtering possible, return empty (no recommendations)
+    if not zipcode and not region and not primary_focus and not substances:
+        return []
+
+    # Build filter functions in order of relaxation priority
+    filters = []
+
+    # Geographic filter (relaxed first if too few results)
+    if zipcode:
+        zip_prefix = zipcode[:3]
+        filters.append(("geo", lambda r, zp=zip_prefix: (
+            r.get("zip", "")[:3] == zp
+        )))
+    elif region:
+        region_lower = region.lower()
+        filters.append(("geo", lambda r, rl=region_lower: (
+            rl in r.get("city", "").lower() or rl in r.get("state", "").lower()
+        )))
+
+    # Primary focus filter
+    if primary_focus:
+        focus_lower = primary_focus.lower()
+        filters.append(("focus", lambda r, fl=focus_lower: (
+            not r.get("primary_focus", "").strip() or
+            fl in _pipe_values(r.get("primary_focus", ""))
+        )))
+
+    # Substances filter
+    if substances:
+        if isinstance(substances, str):
+            substances = [substances]
+        subs_lower = {s.lower() for s in substances}
+        filters.append(("substances", lambda r, sl=subs_lower: (
+            not r.get("substances", "").strip() or
+            bool(sl & _pipe_values(r.get("substances", "")))
+        )))
+
+    # Apply all filters, progressively relax if < 3 results
+    result = _apply_filters(resources, filters)
+    if len(result) >= 3:
+        return result
+    best = result  # keep the best partial matches found so far
+
+    # Relax geographic filter first
+    relaxed = [f for f in filters if f[0] != "geo"]
+    if relaxed:
+        result = _apply_filters(resources, relaxed)
+        if len(result) >= 3:
+            return result
+        if len(result) > len(best):
+            best = result
+
+    # Relax substances filter next
+    relaxed = [f for f in relaxed if f[0] != "substances"]
+    if relaxed:
+        result = _apply_filters(resources, relaxed)
+        if len(result) > len(best):
+            best = result
+
+    return best
+
+
+def _apply_filters(resources, filters):
+    """Apply a list of filter functions, keeping rows that pass all."""
+    if not filters:
+        return []
+    result = []
+    for row in resources:
+        if all(fn(row) for _, fn in filters):
+            result.append(row)
+    return result
+
+
+def score_resources(filtered, user_profile, top_n=3):
+    """
+    Score filtered resources by relevance to the user profile.
+    Returns the top_n highest-scoring resources as a list of dicts.
+    """
+    zipcode = _get_profile_value(user_profile, "logistics", "zipcode")
+    region = _get_profile_value(user_profile, "logistics", "region")
+
+    scored = []
+    for row in filtered:
+        score = 0
+
+        # Score each mapped field
+        for category, field, csv_col, weight in FIELD_MAP:
+            profile_val = _get_profile_value(user_profile, category, field)
+            if profile_val is None:
+                continue
+
+            cell_values = _pipe_values(row.get(csv_col, ""))
+            if not cell_values:
+                continue  # empty cell = neutral
+
+            if isinstance(profile_val, list):
+                matches = sum(1 for v in profile_val if v.lower() in cell_values)
+                if matches > 0:
+                    score += weight * (matches / len(profile_val))
+            else:
+                if profile_val.lower() in cell_values:
+                    score += weight
+
+        # Geographic bonus
+        row_zip = row.get("zip", "").strip()
+        if zipcode and row_zip:
+            if row_zip == zipcode:
+                score += 5
+            elif row_zip[:3] == zipcode[:3]:
+                score += 2
+        elif region and not zipcode:
+            region_lower = region.lower()
+            if region_lower in row.get("city", "").lower():
+                score += 3
+
+        if score > 0:
+            scored.append((score, row))
+
+    # Sort by score descending
+    scored.sort(key=lambda x: x[0], reverse=True)
+    return [row for _, row in scored[:top_n]]
+
+
+def format_recommendations(results):
+    """
+    Format a list of resource dicts into a readable recommendation block.
+    Returns empty string if no results.
+    """
+    if not results:
+        return ""
+
+    lines = [
+        "---",
+        "Here are some resources that may be a good fit for you:",
+        "",
+    ]
+
+    for i, row in enumerate(results, 1):
+        name = row.get("name", "Unknown Facility")
+        lines.append(f"{i}. {name}")
+
+        # Address
+        parts = [row.get("address", ""), row.get("city", ""),
+                 row.get("state", ""), row.get("zip", "")]
+        address = ", ".join(p.strip() for p in parts if p.strip())
+        if address:
+            lines.append(f"   {address}")
+
+        # Phone
+        phone = row.get("phone", "").strip()
+        if phone:
+            lines.append(f"   Phone: {phone}")
+
+        # Website
+        website = row.get("website", "").strip()
+        if website:
+            lines.append(f"   Website: {website}")
+
+        # Summary line: focus, substances, settings
+        details = []
+        focus = row.get("primary_focus", "").strip()
+        if focus:
+            details.append("Focus: " + ", ".join(
+                v.strip().replace("_", " ").title() for v in focus.split("|")
+            ))
+        subs = row.get("substances", "").strip()
+        if subs:
+            details.append("Substances: " + ", ".join(
+                v.strip().replace("_", " ").title() for v in subs.split("|")
+            ))
+        settings = row.get("settings", "").strip()
+        if settings:
+            details.append("Settings: " + ", ".join(
+                v.strip().replace("_", " ").title() for v in settings.split("|")
+            ))
+        if details:
+            lines.append("   " + " | ".join(details))
+
+        lines.append("")
+
+    return "\n".join(lines).rstrip()