added a setup script

.env.example

@@ -18,7 +18,7 @@ FALLBACK_BASE_URL=http://<GCP_IP>:8000/v1
 
 # ── Local Ollama (dev) ────────────────────────────────────────────────────────
 LOCAL_BASE_URL=http://localhost:11434/v1
-LOCAL_MODEL=gemma4:31b-cloud     # qwen3:8b qwen3.5:397b-cloud 
+LOCAL_MODEL=gemma4:31b-cloud
 
 # ── MLflow ────────────────────────────────────────────────────────────────────
 MLFLOW_TRACKING_URI=mlruns

setup.sh

@@ -0,0 +1,73 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+CONDA_ENV="aac-chatbot"
+ENV_FILE=".env"
+ENV_EXAMPLE=".env.example"
+
+info()  { printf "\033[1;34m==> %s\033[0m\n" "$1"; }
+ok()    { printf "\033[1;32m==> %s\033[0m\n" "$1"; }
+warn()  { printf "\033[1;33m==> %s\033[0m\n" "$1"; }
+fail()  { printf "\033[1;31mERROR: %s\033[0m\n" "$1"; exit 1; }
+
+# ── Pre-flight: conda ────────────────────────────────────────────────────────
+command -v conda >/dev/null 2>&1 || fail "conda not found. Install Miniconda/Anaconda first."
+
+# ── Conda environment ────────────────────────────────────────────────────────
+if conda info --envs | grep -q "^${CONDA_ENV} "; then
+  info "Conda env '$CONDA_ENV' already exists — reusing it"
+else
+  info "Creating conda env '$CONDA_ENV' (Python 3.12)..."
+  conda create -n "$CONDA_ENV" python=3.12 -y --quiet
+  ok "Conda env created"
+fi
+
+# Activate inside this script
+eval "$(conda shell.bash hook)"
+conda activate "$CONDA_ENV"
+
+# ── Install dependencies ─────────────────────────────────────────────────────
+info "Installing Python dependencies..."
+pip install --upgrade pip --quiet
+pip install -r requirements.txt --quiet
+ok "Dependencies installed"
+
+# ── Environment file ─────────────────────────────────────────────────────────
+if [ -f "$ENV_FILE" ]; then
+  warn ".env already exists — skipping copy (review $ENV_EXAMPLE for new vars)"
+else
+  info "Copying $ENV_EXAMPLE → $ENV_FILE..."
+  cp "$ENV_EXAMPLE" "$ENV_FILE"
+  ok ".env created — edit it to configure LLM tiers and endpoints"
+fi
+
+# ── FAISS index build ────────────────────────────────────────────────────────
+info "Building FAISS indexes (downloads BGE embedder + reranker on first run)..."
+python -m retrieval.vector_store
+ok "FAISS indexes built in data/faiss_store/"
+
+# ── Ollama model pull ────────────────────────────────────────────────────────
+if ! command -v ollama >/dev/null 2>&1; then
+  warn "Ollama not installed — install it from https://ollama.com then re-run this script"
+else
+  LOCAL_MODEL=$(grep -E '^LOCAL_MODEL=' "$ENV_FILE" 2>/dev/null | cut -d= -f2 | sed 's/#.*//' | tr -d ' ' || echo "qwen3:8b")
+  [ -z "$LOCAL_MODEL" ] && LOCAL_MODEL="qwen3:8b"
+  info "Pulling Ollama model: $LOCAL_MODEL (skips if already pulled)..."
+  ollama pull "$LOCAL_MODEL"
+  ok "Ollama model $LOCAL_MODEL ready"
+fi
+
+# ── Done ──────────────────────────────────────────────────────────────────────
+echo ""
+ok "Setup complete!"
+echo ""
+echo "  Activate the environment:"
+echo "    conda activate $CONDA_ENV"
+echo ""
+echo "  Run the CLI:"
+echo "    python main.py --debug"
+echo ""
+echo "  Or start the full stack:"
+echo "    uvicorn api.main:app --reload    # FastAPI on :8000"
+echo "    streamlit run ui/app.py          # Streamlit on :8501"
+echo ""