| --- |
| title: Insta-AutoApp |
| emoji: 🚙 |
| colorFrom: yellow |
| colorTo: blue |
| sdk: gradio |
| sdk_version: 4.44.1 |
| python_version: 3.11 |
| app_file: app_spaces.py |
| pinned: false |
| --- |
| |
|
|
|
|
|
|
| # Insta-AutoApp |
|
|
| **AI-powered symptom triage for 2023 Ford Bronco owners.** |
|
|
| Describe a warning light or abnormal vehicle behavior in plain English. Insta-AutoApp retrieves relevant sections from the official 642-page OEM Owner's Manual using FAISS semantic search, then returns a structured triage: urgency level, likely meaning, recommended next step, and OEM citation. |
|
|
| Built on a **6-Agent Pipeline Architecture**: IntakeAgent → ProfileAgent → ClarificationAgent → RetrievalAgent → DiagnosticAgent → PresentationAgent. |
|
|
| **Team Data Mavericks** · Nasser Chaudhry · Miriam Camacho · Neil Driscoll |
| ANLY 601 · Mays Business School · Texas A&M University |
|
|
| --- |
|
|
| ## Deploy to HuggingFace Spaces |
|
|
| 1. Create a new Space at [huggingface.co/new-space](https://huggingface.co/new-space) with **Gradio** SDK |
| 2. **Upload ALL files to the repo root** (no subfolders). The complete file list: |
| - `README.md`, `app.py`, `app_spaces.py`, `config.py`, `ingest.py`, `llm_client.py`, `prompts.py`, `rag_pipeline.py`, `requirements.txt`, `.env.example`, `.gitignore` |
| - **Data files at root too:** `index.faiss`, `index.pkl`, `2023_Ford_Bronco_Owners_Manual_version_1_om_EN-US.pdf` |
| 3. Go to **Settings > Secrets** and add: `HF_TOKEN` = your HuggingFace API token |
| 4. The Space will auto-build and launch |
|
|
| The app auto-detects whether data files are at root (HF Spaces flat upload) or in a `data/` subfolder (local dev). If `index.faiss` is missing but the PDF is present, the app will auto-rebuild the index on first launch. |
|
|
| --- |
|
|
| ## How It Works |
|
|
| 1. **Describe** — Type your symptom in plain English |
| 2. **Clarify** — App asks 1–2 Bronco-specific follow-up questions |
| 3. **Retrieve** — FAISS searches 645 OEM manual chunks for relevant sections |
| 4. **Triage** — LLM returns urgency, meaning, next step, and OEM citation |
|
|
| Every response includes a safety disclaimer. Safety-critical symptoms (brakes, steering, overheating) trigger conservative urgency escalation. |
|
|
| --- |
|
|
| ## Privacy Notice |
|
|
| Symptom descriptions are sent to the configured LLM provider (HuggingFace or Anthropic) for triage analysis. No personal identity information is collected. |
|
|
