Clean initial commit for HF Spaces (exclude venv & binaries)

.env

@@ -0,0 +1,5 @@
+# Desktop paths
+DATA_DIR=/Users/gen.overseerlupo/Desktop/grants_rag_app/data
+DOCSTORE_DIR=/Users/gen.overseerlupo/Desktop/grants_rag_app/data/docstore
+INDEX_DIR=/Users/gen.overseerlupo/Desktop/grants_rag_app/data/index
+EXPORT_DIR=/Users/gen.overseerlupo/Desktop/grants_rag_app/data/exports

.env.example

@@ -0,0 +1,5 @@
+# Desktop paths
+DATA_DIR=/Users/gen.overseerlupo/Desktop/grants_rag_app/data
+DOCSTORE_DIR=/Users/gen.overseerlupo/Desktop/grants_rag_app/data/docstore
+INDEX_DIR=/Users/gen.overseerlupo/Desktop/grants_rag_app/data/index
+EXPORT_DIR=/Users/gen.overseerlupo/Desktop/grants_rag_app/data/exports

.gitattributes

@@ -0,0 +1,5 @@
+assets/*.{jpg filter=lfs diff=lfs merge=lfs -text
+jpeg filter=lfs diff=lfs merge=lfs -text
+png filter=lfs diff=lfs merge=lfs -text
+gif filter=lfs diff=lfs merge=lfs -text
+webp} filter=lfs diff=lfs merge=lfs -text

.gitignore

@@ -0,0 +1,14 @@
+.venv/
+__pycache__/
+*.pyc
+.DS_Store
+*.so
+*.dylib
+*.dll
+*.map
+*.bin
+*.pt
+*.pth
+*.npy
+data/index/
+data/docstore/

Makefile

@@ -0,0 +1,29 @@
+.PHONY: ingest export ui clean venv stop restart ps
+
+venv:
+	python3 -m venv .venv && . .venv/bin/activate && pip install -U pip wheel && pip install -r requirements.txt
+
+ingest:
+	python app/main.py ingest
+
+search:
+	python app/main.py search --q "capacity building"
+
+export:
+	python app/main.py export --q "capacity building" --out data/exports/results.csv
+
+ui:
+	streamlit run app/ui_streamlit.py
+
+ps:
+	ps aux | grep streamlit | grep -v grep || true
+
+stop:
+	- pkill -f "streamlit run app/ui_streamlit.py" || true
+	- pgrep -f "streamlit" | xargs kill -9 2>/dev/null || true
+
+restart: stop
+	streamlit run app/ui_streamlit.py
+
+clean:
+	rm -rf data/index data/docstore data/exports/*.csv

README.md

@@ -0,0 +1,34 @@
+# Grants Discovery RAG App (v6.2 hotfix)
+
+---
+title: Grants RAG Finder
+sdk: streamlit
+app_file: app/ui_streamlit.py
+---
+
+
+- Desktop paths baked in
+- Grants.gov API + topic routes (General, Elderly, Prison, Evangelism, Vehicles, FTA 5310)
+- Makefile helpers: `make ps`, `make stop`, `make restart`
+- **Hotfix**: corrected Streamlit write line (single line, no syntax error)
+
+## One-Time Setup
+```bash
+cd ~/Desktop
+unzip ~/Downloads/grants_rag_app_desktop_v6_2.zip -d ~/Desktop/
+cd /Users/gen.overseerlupo/Desktop/grants_rag_app
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -U pip wheel
+pip install -r requirements.txt
+cp .env.example .env
+open -a TextEdit .env config/sources.yaml
+```
+
+## Run
+```bash
+cd /Users/gen.overseerlupo/Desktop/grants_rag_app
+source .venv/bin/activate
+make ingest
+make ui
+```

app/ingest.py

@@ -0,0 +1,146 @@
+import os, json
+from pathlib import Path
+from typing import Dict, List
+import yaml
+from sentence_transformers import SentenceTransformer
+import numpy as np
+from app.sources.grantsgov_api import load_fallback_json    # ← add this line
+
+
+def load_config(cfg_path: str) -> Dict:
+    with open(cfg_path, "r") as f:
+        return yaml.safe_load(f)
+
+def ensure_dirs(env: Dict):
+    Path(env["DOCSTORE_DIR"]).mkdir(parents=True, exist_ok=True)
+    Path(env["INDEX_DIR"]).mkdir(parents=True, exist_ok=True)
+
+def hash_id(text: str) -> str:
+    import hashlib
+    return hashlib.sha1(text.encode("utf-8")).hexdigest()[:16]
+
+def normalize_record(src_name: str, rec: Dict) -> Dict:
+    return {
+        "id": rec.get("id") or hash_id(rec.get("title","") + rec.get("url","")),
+        "source": src_name,
+        "title": rec.get("title","").strip(),
+        "summary": rec.get("summary","").strip(),
+        "url": rec.get("url","").strip(),
+        "deadline": rec.get("deadline","").strip(),
+        "eligibility": rec.get("eligibility","").strip(),
+        "agency": rec.get("agency","").strip(),
+        "geo": rec.get("geo","").strip(),
+        "categories": rec.get("categories", []),
+        "raw": rec
+    }
+
+def collect_from_grantsgov_api(src: Dict) -> List[Dict]:
+    # Import here so module runs cleanly
+    from app.sources.grantsgov_api import search_grants, map_to_records, load_fallback_json
+
+    # Read API config from YAML
+    api_cfg = src.get("api", {})
+    page_size = int(api_cfg.get("page_size", 100))
+    max_pages = int(api_cfg.get("max_pages", 5))
+    payload = api_cfg.get("payload", {}) or {}
+
+    # Try live API first (POST+JSON). If it fails, use local fallback_json (if provided).
+    try:
+        items = search_grants(src.get("url"), payload, page_size=page_size, max_pages=max_pages)
+    except Exception as e:
+        fb = src.get("fallback_json")
+        if fb:
+            print(f"[WARN] API failed ({e}); using fallback: {fb}")
+            items = load_fallback_json(fb)
+        else:
+            raise
+
+    # Map raw items to a basic schema (id/title/summary/agency/dates)
+    basic = map_to_records(items)
+
+    # Enrich with fields our normalize_record expects
+    geo = src.get("geo", "US")
+    categories = src.get("categories", [])
+    recs: List[Dict] = []
+    for b in basic:
+        raw = b.get("raw") or {}
+        # Try to find a URL if present in the raw payload
+        url = (
+            raw.get("opportunityUrl")
+            or raw.get("synopsisURL")
+            or raw.get("url")
+            or ""
+        )
+        deadline = b.get("closeDate") or raw.get("closeDate") or ""
+
+        rec = {
+            "id": b.get("id"),
+            "title": b.get("title") or "",
+            "summary": b.get("summary") or "",
+            "url": url,
+            "deadline": deadline,
+            "eligibility": raw.get("eligibility") or "",
+            "agency": b.get("agency") or raw.get("agency") or "",
+            "geo": geo,
+            "categories": categories,
+        }
+        recs.append(normalize_record(src["name"], rec))
+
+    return recs
+
+
+def save_docstore(recs: List[Dict], env: Dict):
+    ds_path = Path(env["DOCSTORE_DIR"]) / "docstore.jsonl"
+    with open(ds_path, "w") as f:
+        for r in recs:
+            f.write(json.dumps(r) + "\n")
+    return str(ds_path)
+
+def build_index(env: Dict):
+    ds_path = Path(env["DOCSTORE_DIR"]) / "docstore.jsonl"
+    if not ds_path.exists():
+        raise RuntimeError("Docstore not found. Run ingest first.")
+    model = SentenceTransformer("all-MiniLM-L6-v2")
+    texts = []
+    metas = []
+    with open(ds_path, "r") as f:
+        for line in f:
+            rec = json.loads(line)
+            text = " | ".join([rec.get("title",""), rec.get("summary",""), rec.get("eligibility",""), rec.get("agency","")])
+            texts.append(text)
+            metas.append({"id": rec["id"], "title": rec["title"], "url": rec["url"], "source": rec["source"], "geo": rec["geo"], "categories": rec["categories"]})
+    emb = model.encode(texts, convert_to_numpy=True, show_progress_bar=True, normalize_embeddings=True)
+
+    import faiss
+    dim = emb.shape[1]
+    index = faiss.IndexFlatIP(dim)
+    index.add(emb)
+
+    Path(env["INDEX_DIR"]).mkdir(parents=True, exist_ok=True)
+    faiss.write_index(index, str(Path(env["INDEX_DIR"]) / "faiss.index"))
+    with open(Path(env["INDEX_DIR"]) / "meta.json", "w") as f:
+        json.dump(metas, f)
+    return len(texts)
+
+def ingest(cfg_path: str, env: Dict):
+    cfg = load_config(cfg_path)
+    ensure_dirs(env)
+    all_recs = []
+    for src in cfg.get("sources", []):
+        if not src.get("enabled", False):
+            continue
+        if src["type"] == "grantsgov_api":
+            recs = collect_from_grantsgov_api(src)
+        else:
+            recs = []
+        all_recs.extend(recs)
+    path = save_docstore(all_recs, env)
+    n_indexed = build_index(env)
+    return path, n_indexed
+
+if __name__ == "__main__":
+    from dotenv import dotenv_values
+    env = dotenv_values(".env")
+    cfg_path = "config/v6.yaml"
+    p, n = ingest(cfg_path, env)
+    print(f"Ingested {n} records. Docstore at {p}")

app/main.py

@@ -0,0 +1,77 @@
+import argparse, os, json
+from pathlib import Path
+from dotenv import dotenv_values
+import pandas as pd
+
+from app.ingest import ingest
+from app.search import search
+
+def get_env():
+    env = dotenv_values(".env")
+    if not env:
+        env = {
+            "DATA_DIR":"data",
+            "DOCSTORE_DIR":"data/docstore",
+            "INDEX_DIR":"data/index",
+            "EXPORT_DIR":"data/exports",
+        }
+    for k in ["DATA_DIR","DOCSTORE_DIR","INDEX_DIR","EXPORT_DIR"]:
+        os.makedirs(env[k], exist_ok=True)
+    return env
+
+def cmd_ingest(args):
+    env = get_env()
+    path, n = ingest("config/sources.yaml", env)
+    print(f"Ingest complete. {n} records. Docstore: {path}")
+
+def cmd_search(args):
+    env = get_env()
+    filters = {}
+    if args.geo:
+        filters["geo"] = args.geo.split(",")
+    if args.categories:
+        filters["categories"] = args.categories.split(",")
+    res = search(args.q, env, top_k=args.k, filters=filters)
+    for r in res:
+        print(f"- {r['title']} [{r['source']}] ({r['geo']}) score={r['score']:.3f}")
+        print(f"  {r['url']}")
+
+def cmd_export(args):
+    env = get_env()
+    filters = {}
+    if args.geo:
+        filters["geo"] = args.geo.split(",")
+    if args.categories:
+        filters["categories"] = args.categories.split(",")
+    res = search(args.q, env, top_k=args.k, filters=filters)
+    out = Path(env["EXPORT_DIR"]) / (args.out or "results.csv")
+    pd.DataFrame(res).to_csv(out, index=False)
+    print(f"Exported {len(res)} rows to {out}")
+
+if __name__ == "__main__":
+    p = argparse.ArgumentParser()
+    sub = p.add_subparsers(dest="cmd")
+
+    p_ing = sub.add_parser("ingest", help="Ingest sources and build index")
+    p_ing.set_defaults(func=cmd_ingest)
+
+    p_search = sub.add_parser("search", help="Search index")
+    p_search.add_argument("--q", required=True)
+    p_search.add_argument("--k", type=int, default=15)
+    p_search.add_argument("--geo", default="")
+    p_search.add_argument("--categories", default="")
+    p_search.set_defaults(func=cmd_search)
+
+    p_export = sub.add_parser("export", help="Export search results to CSV")
+    p_export.add_argument("--q", required=True)
+    p_export.add_argument("--k", type=int, default=50)
+    p_export.add_argument("--geo", default="")
+    p_export.add_argument("--categories", default="")
+    p_export.add_argument("--out", default="results.csv")
+    p_export.set_defaults(func=cmd_export)
+
+    args = p.parse_args()
+    if not args.cmd:
+        p.print_help()
+    else:
+        args.func(args)

app/search.py

@@ -0,0 +1,37 @@
+import json
+from pathlib import Path
+from typing import List, Dict
+from sentence_transformers import SentenceTransformer
+import numpy as np
+
+def load_index(env: Dict):
+    import faiss, json
+    index_path = Path(env["INDEX_DIR"]) / "faiss.index"
+    meta_path = Path(env["INDEX_DIR"]) / "meta.json"
+    if not index_path.exists():
+        raise RuntimeError("Index not found. Run ingest first.")
+    index = faiss.read_index(str(index_path))
+    metas = json.load(open(meta_path))
+    return index, metas
+
+def embed(texts: List[str]):
+    model = SentenceTransformer("all-MiniLM-L6-v2")
+    return model.encode(texts, convert_to_numpy=True, normalize_embeddings=True)
+
+def search(q: str, env: Dict, top_k: int = 15, filters: Dict = None) -> List[Dict]:
+    index, metas = load_index(env)
+    qv = embed([q])
+    scores, idxs = index.search(qv, top_k)
+    results = []
+    for score, idx in zip(scores[0], idxs[0]):
+        if idx == -1: continue
+        m = metas[idx]
+        if filters:
+            if "geo" in filters and filters["geo"] and m.get("geo") not in filters["geo"]:
+                continue
+            if "categories" in filters and filters["categories"]:
+                if not set(filters["categories"]).intersection(set(m.get("categories",[]))):
+                    continue
+        m["score"] = float(score)
+        results.append(m)
+    return results

app/sources/grantsgov_api.py

@@ -0,0 +1,120 @@
+# app/sources/grantsgov_api.py
+import os
+import time
+import json
+import logging
+from typing import Dict, List, Tuple
+import requests
+
+log = logging.getLogger(__name__)
+
+DEFAULT_URL = "https://apply07.grants.gov/grantsws/rest/opportunities/search/"
+
+def _session():
+    s = requests.Session()
+    s.headers.update({
+        "Accept": "application/json",
+        "Content-Type": "application/json",
+        "User-Agent": "grants-rag-app/0.1 (+https://awakeningacts.org)"
+    })
+    return s
+
+def search_grants(
+    url: str,
+    payload: Dict,
+    page_size: int = 50,
+    max_pages: int = 5,
+    delay_sec: float = 0.4
+) -> List[Dict]:
+    """
+    Calls Grants.gov search API with POST+JSON.
+    Paginates using numRecords + startRecordNum (1-based).
+    Returns list of 'opportunity' dicts.
+    """
+    url = (url or DEFAULT_URL).rstrip("/") + "/"
+    sess = _session()
+    results: List[Dict] = []
+
+    start = 1
+    for page in range(max_pages):
+        body = dict(payload or {})
+        # Typical pagination keys accepted by the API
+        body.setdefault("oppStatuses", "posted")  # adjust if you want all statuses
+        body["numRecords"] = page_size
+        body["startRecordNum"] = start
+
+        try:
+            resp = sess.post(url, json=body, timeout=30)
+            # If servers briefly reject, a short retry helps
+            if resp.status_code in (502, 503, 504):
+                time.sleep(1.0)
+                resp = sess.post(url, json=body, timeout=30)
+            resp.raise_for_status()
+        except requests.HTTPError as e:
+            # Provide a helpful log and bubble up so caller can decide fallback
+            msg = f"Grants.gov search failed (status {getattr(resp,'status_code',None)}): {e}"
+            log.error(msg)
+            raise
+        except requests.RequestException as e:
+            log.error(f"Network error calling Grants.gov: {e}")
+            raise
+
+        data = resp.json() if resp.content else {}
+        # API typically returns 'opportunities' or 'oppHits' style structures.
+        items = (
+            data.get("opportunities")
+            or data.get("oppHits")
+            or data.get("searchResults")
+            or []
+        )
+
+        if not items:
+            break
+
+        results.extend(items)
+        # If fewer than a full page returned, we've reached the end.
+        if len(items) < page_size:
+            break
+
+        start += page_size
+        if delay_sec:
+            time.sleep(delay_sec)
+
+    return results
+
+
+def map_to_records(items: List[Dict]) -> List[Dict]:
+    """
+    Map raw Grants.gov items to your internal record schema used by the app.
+    Tweak keys below to match your indexer.
+    """
+    out = []
+    for it in items or []:
+        # These keys vary depending on API flavor; use .get(...) to be safe.
+        out.append({
+            "id": it.get("opportunityNumber") or it.get("opportunityId") or it.get("id"),
+            "title": it.get("opportunityTitle") or it.get("title"),
+            "summary": it.get("synopsis") or it.get("description") or it.get("summary"),
+            "agency": it.get("agency"),  # sometimes 'agencyCode' / 'agencyName'
+            "postedDate": it.get("postedDate") or it.get("openDate"),
+            "closeDate": it.get("closeDate") or it.get("closeDateExplanation"),
+            "raw": it,  # keep original for debugging
+        })
+    return out
+
+
+# ---------- Optional Local Fallback Utilities ----------
+
+def load_fallback_json(path: str) -> List[Dict]:
+    try:
+        with open(path, "r") as f:
+            data = json.load(f)
+        # allow either {"opportunities":[...]} or just [...]
+        if isinstance(data, dict):
+            data = data.get("opportunities") or data.get("items") or data.get("data") or []
+        if not isinstance(data, list):
+            return []
+        return data
+    except Exception as e:
+        log.error(f"Failed to load fallback json: {e}")
+        return []

app/ui_streamlit.py

@@ -0,0 +1,68 @@
+import os, json
+import streamlit as st
+from dotenv import dotenv_values
+from app.search import search
+
+st.set_page_config(page_title="Grants Discovery RAG", layout="wide")
+st.title("Grants Discovery RAG (Capacity Building)")
+
+env = dotenv_values(".env")
+if not env:
+    st.warning("No .env found. Using defaults.")
+    env = {
+        "DATA_DIR":"data",
+        "DOCSTORE_DIR":"data/docstore",
+        "INDEX_DIR":"data/index",
+        "EXPORT_DIR":"data/exports",
+    }
+
+preset = st.radio("Quick topic:", ["General", "Elderly", "Prison Ministry", "Evangelism", "Vehicles/Transport", "FTA 5310"], horizontal=True)
+default_q = {
+    "General": "capacity building",
+    "Elderly": "capacity building for seniors and aging services",
+    "Prison Ministry": "capacity building for reentry and prison ministry",
+    "Evangelism": "capacity building for faith and community outreach",
+    "Vehicles/Transport": "capacity building transportation vehicles vans buses mobility",
+    "FTA 5310": "5310 Enhanced Mobility Seniors Individuals with Disabilities",
+}.get(preset, "capacity building")
+
+q = st.text_input("Search query", value=default_q)
+geo = st.multiselect("Geo filter", options=["US","MD","MA"], default=["US"])
+cats = st.multiselect("Category filter", options=["capacity_building","elderly","prison_ministry","evangelism","transportation","vehicle"], default=["capacity_building"])
+top_k = st.slider("Results", 5, 50, 15)
+
+col1, col2 = st.columns([1,1])
+with col1:
+    if st.button("Search"):
+        try:
+            results = search(q, env, top_k=top_k, filters={"geo": geo, "categories": cats})
+            st.session_state["results"] = results
+        except Exception as e:
+            st.error(str(e))
+
+with col2:
+    if st.button("Export Results to CSV"):
+        results = st.session_state.get("results", [])
+        if not results:
+            st.warning("No results to export. Run a search first.")
+        else:
+            os.makedirs(env["EXPORT_DIR"], exist_ok=True)
+            out_path = os.path.join(env["EXPORT_DIR"], "results.csv")
+            import pandas as pd
+            pd.DataFrame(results).to_csv(out_path, index=False)
+            st.success(f"Exported to {out_path}")
+
+st.markdown("---")
+results = st.session_state.get("results", [])
+if results:
+    for r in results:
+        st.markdown(f"### {r.get('title','(no title)')}")
+        st.write(f"**Source:** {r.get('source','')} | **Geo:** {r.get('geo','')} | **Categories:** {', '.join(r.get('categories',[]))}")
+        link = r.get('url','')
+        if link and not link.startswith("http"):
+            st.caption("Note: This item may display an ID or number instead of a full link. Open on Grants.gov if needed.")
+        # ✅ Fixed: one line, no syntax error
+        st.write(f"[Open Link]({link})  \nScore: {r.get('score', 0):.3f}")
+        st.markdown("---")
+else:
+    st.info("Enter a query and click Search.")

config/sources.yaml

@@ -0,0 +1,44 @@
+# Minimal, valid config — v6.2
+sources:
+  - name: "Grants.gov (API: capacity building - general)"
+    type: grantsgov_api
+    enabled: true
+    url: "https://www.grants.gov/grantsws/rest/opportunities/search/"
+    geo: "US"
+    categories: ["capacity_building"]
+    api:
+      page_size: 100
+      max_pages: 5
+      payload:
+        keyword: "capacity building"
+        opportunityStatuses: ["posted"]
+        sortBy: "openDate|desc"
+
+  - name: "Grants.gov (API: capacity building - vehicles/transportation)"
+    type: grantsgov_api
+    enabled: true
+    url: "https://www.grants.gov/grantsws/rest/opportunities/search/"
+    geo: "US"
+    categories: ["capacity_building", "transportation", "vehicle"]
+    api:
+      page_size: 100
+      max_pages: 5
+      payload:
+        keyword: "capacity building transportation vehicle bus van transit mobility"
+        opportunityStatuses: ["posted"]
+        sortBy: "openDate|desc"
+
+  - name: "Grants.gov (API: FTA Section 5310 - Enhanced Mobility)"
+    type: grantsgov_api
+    enabled: true
+    url: "https://www.grants.gov/grantsws/rest/opportunities/search/"
+    geo: "US"
+    categories: ["capacity_building", "elderly", "transportation", "vehicle"]
+    api:
+      page_size: 100
+      max_pages: 3
+      payload:
+        keyword: "5310 Enhanced Mobility Seniors Individuals with Disabilities"
+        opportunityStatuses: ["posted"]
+        sortBy: "openDate|desc"
+        agencyCodes: ["FTA"]

config/v6.yaml

@@ -0,0 +1,52 @@
+# Minimal, valid config — v6.2
+sources:
+  - name: "Grants.gov (API: capacity building - general)"
+    type: grantsgov_api
+    enabled: true
+    url: "https://apply07.grants.gov/grantsws/rest/opportunities/search/"
+    fallback_json: data/grants_fallback_sample.json
+    geo: "US"
+    categories:
+      - capacity_building
+    api:
+      page_size: 25
+      max_pages: 1
+      payload:
+        keyword: "capacity building"
+        oppStatuses: "posted"
+
+  - name: "Grants.gov (API: capacity building - vehicles/transportation)"
+    type: grantsgov_api
+    enabled: true
+    url: "https://apply07.grants.gov/grantsws/rest/opportunities/search/"
+    fallback_json: data/grants_fallback_sample.json
+    geo: "US"
+    categories:
+      - capacity_building
+      - transportation
+      - vehicle
+    api:
+      page_size: 25
+      max_pages: 1
+      payload:
+        keyword: "capacity building transportation vehicle bus van transit mobility"
+        oppStatuses: "posted"
+
+  - name: "Grants.gov (API: FTA Section 5310 - Enhanced Mobility)"
+    type: grantsgov_api
+    enabled: true
+    url: "https://apply07.grants.gov/grantsws/rest/opportunities/search/"
+    fallback_json: data/grants_fallback_sample.json
+    geo: "US"
+    categories:
+      - capacity_building
+      - elderly
+      - transportation
+      - vehicle
+    api:
+      page_size: 25
+      max_pages: 1
+      payload:
+        keyword: "5310 Enhanced Mobility Seniors Individuals with Disabilities"
+        oppStatuses: "posted"
+        agencyCodes: ["FTA"]

data/exports/results.csv

@@ -0,0 +1,7 @@
+id,title,url,source,geo,categories,score
+SAMPLE-002,Senior Services Capacity Grant,,Grants.gov (API: FTA Section 5310 - Enhanced Mobility),US,"['capacity_building', 'elderly', 'transportation', 'vehicle']",0.27466529607772827
+SAMPLE-002,Senior Services Capacity Grant,,Grants.gov (API: capacity building - vehicles/transportation),US,"['capacity_building', 'transportation', 'vehicle']",0.27466529607772827
+SAMPLE-002,Senior Services Capacity Grant,,Grants.gov (API: capacity building - general),US,['capacity_building'],0.27466529607772827
+SAMPLE-001,Community Outreach Mini-Grant,,Grants.gov (API: FTA Section 5310 - Enhanced Mobility),US,"['capacity_building', 'elderly', 'transportation', 'vehicle']",0.028130291029810905
+SAMPLE-001,Community Outreach Mini-Grant,,Grants.gov (API: capacity building - vehicles/transportation),US,"['capacity_building', 'transportation', 'vehicle']",0.028130291029810905
+SAMPLE-001,Community Outreach Mini-Grant,,Grants.gov (API: capacity building - general),US,['capacity_building'],0.028130291029810905

data/grants_fallback_sample.json

@@ -0,0 +1,20 @@
+{
+  "opportunities": [
+    {
+      "opportunityNumber": "SAMPLE-001",
+      "opportunityTitle": "Community Outreach Mini-Grant",
+      "synopsis": "Supports local nonprofits delivering basic needs and outreach services.",
+      "agency": "Sample Foundation",
+      "postedDate": "2025-09-01",
+      "closeDate": "2025-10-15"
+    },
+    {
+      "opportunityNumber": "SAMPLE-002",
+      "opportunityTitle": "Senior Services Capacity Grant",
+      "synopsis": "Capacity building for organizations serving seniors (case management, benefits access).",
+      "agency": "Sample City",
+      "postedDate": "2025-08-25",
+      "closeDate": "2025-10-01"
+    }
+  ]
+}

requirements.txt

@@ -0,0 +1,10 @@
+streamlit>=1.36
+pydantic>=2.7
+python-dotenv>=1.0
+pandas>=2.2
+numpy>=1.26
+faiss-cpu>=1.8
+sentence-transformers>=3.0
+requests>=2.32
+pyyaml>=6.0
+tqdm>=4.66

run.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+set -e
+cd "$(dirname "$0")"
+
+# Activate venv (create if missing)
+if [ ! -d ".venv" ]; then
+  python3 -m venv .venv
+fi
+source .venv/bin/activate
+
+# Make imports work and launch the UI
+export PYTHONPATH="$(pwd)"
+python -m streamlit run app/ui_streamlit.py