Update app.py

app.py

@@ -0,0 +1,412 @@
+✨🚀 The ULTIMATE Step-by-Step V1.0 Build Guide for Your AI Travel Bot (Granular for Beginners)
+
+Welcome, future coder! 🎉 This guide contains every single step and command you need—no external references required. Follow along on Windows 11, and you'll have a working AI Travel Bot by the end.
+
+📋 Prerequisites (Install Everything First)
+
+Before we begin, install all tools below. Each is required for the project.
+
+Git
+
+Open your browser to https://git-scm.com/downloads
+
+Click Download for Windows.
+
+Run the downloaded installer (Git-*.exe).
+
+In each dialog: click Next, accept defaults, then Finish.
+
+Verify by opening Command Prompt and running:
+
+
+
+git --version
+```
+You should see git version 2.x.x.
+
+Python 3.10+
+
+Go to https://python.org/downloads
+
+Click Download Python 3.10.x.
+
+Run the installer.
+
+Important: Check Add Python to PATH.
+
+Click Install Now.
+
+Verify:
+
+
+
+python --version
+```
+You should see Python 3.10.x.
+
+Node.js (LTS)
+
+Visit https://nodejs.org/en/download/
+
+Download Windows Installer (.msi) for LTS.
+
+Run the installer: Next → Next → Install → Finish.
+
+Verify:
+
+
+
+node --version
+npm --version
+```
+You should see versions (e.g., v18.x.x, 8.x.x).
+
+Hugging Face Account
+
+Open https://huggingface.co/ and click Sign up.
+
+Register with your email or GitHub.
+
+Confirm your email and log in.
+
+1️⃣ Create Your Online Home: Hugging Face Space
+
+In your browser, go to https://huggingface.co/spaces.
+
+Click Create new Space (blue button top right).
+
+Fill in:
+
+Space name: WanderlustAI-v1
+
+SDK: select Gradio
+
+Visibility: choose Public for now
+
+Click Create Space.
+
+Wait until you see the file explorer panel on the left. That’s your project directory.
+
+2️⃣ Set Up Your Project Files (The Skeleton)
+
+In the Hugging Face Space file explorer, create these files one at a time:
+
+app.py
+
+Click Add file → Create file.
+
+Enter app.py → click Create.
+
+README.md
+
+Add file → README.md → Create.
+
+.env.example
+
+Add file → .env.example → Create.
+
+requirements.txt
+
+Add file → requirements.txt → Create.
+
+packages.txt
+
+Add file → packages.txt → Create.
+
+Confirm all five files appear in the list.
+
+3️⃣ Document the Essentials (Fill In Templates)
+
+3.1 README.md
+
+Click README.md → pencil icon to edit.
+
+Paste:
+
+# AI Travel Bot
+This project builds an AI-powered travel assistant using ChatGPT and web scraping.
+
+## How to Use
+1. Set up secrets in `.env`.
+2. Run `python app.py` locally or deploy on Hugging Face.
+
+Click Commit changes.
+
+3.2 .env.example
+
+Open .env.example → edit.
+
+Paste:
+
+OPENAI_API_KEY=YOUR_OPENAI_KEY_HERE
+GOOGLE_API_KEY=YOUR_GOOGLE_KEY_HERE
+
+Commit changes.
+
+4️⃣ List Your Tools (Dependencies)
+
+4.1 requirements.txt
+
+Open requirements.txt → edit.
+
+Paste exactly:
+
+gradio
+langchain
+langchain-openai
+langchain-google-genai
+langchain-community
+playwright
+scrapy
+beautifulsoup4
+lxml
+requests
+python-dotenv
+cachetools
+tenacity
+
+Commit changes.
+
+4.2 packages.txt
+
+Open packages.txt → edit.
+
+Paste:
+
+chromium-driver
+
+Commit changes.
+
+5️⃣ Secure Your Secrets (Add Real Keys)
+
+In the Space UI, click Settings (top menu).
+
+Scroll to Repository secrets → click New secret.
+
+Add:
+
+Name: OPENAI_API_KEY
+
+Value: paste your actual key
+
+Click Add secret.
+
+Repeat for:
+
+GOOGLE_API_KEY
+
+🔒 Secrets are hidden; your code will read them via os.environ.
+
+6️⃣ Build the Brain: Full app.py Code (One Paste)
+
+Open app.py → click pencil.
+
+Delete any existing text.
+
+Copy & paste the ENTIRE code below in one go:
+
+# 1. IMPORTS & SETUP
+import asyncio
+import datetime
+import logging
+import os
+import gradio as gr
+from cachetools import TTLCache
+from langchain_core.output_parsers import JsonOutputParser
+from langchain_core.prompts import ChatPromptTemplate
+from langchain_core.pydantic_v1 import BaseModel, Field
+from langchain_openai import ChatOpenAI
+
+# Configure logging
+logging.basicConfig(
+    level=logging.INFO,
+    format='%(asctime)s - %(levelname)s - %(message)s'
+)
+
+# Simple in-memory cache
+ttl_cache = TTLCache(maxsize=100, ttl=3600)
+
+# 2. DATA MODEL
+class TravelRequest(BaseModel):
+    origin_city: str = Field(description="Starting city or airport")
+    destination_city: str = Field(description="Destination city or airport")
+    start_date: str = Field(description="Trip start date (YYYY-MM-DD)")
+    end_date: str = Field(description="Trip end date (YYYY-MM-DD)")
+    budget: int = Field(description="Total budget in USD")
+    interests: list[str] = Field(description="List of interests like 'hiking', 'museums'")
+
+# 3. PARSE USER INPUT
+async def _extract_user_request(question: str) -> dict:
+    llm = ChatOpenAI(model="gpt-4o", temperature=0)
+    parser = JsonOutputParser(pydantic_object=TravelRequest)
+    prompt = ChatPromptTemplate.from_messages([
+        ("system", "You are a travel assistant. Extract details into JSON."),
+        ("human", "{format_instructions}\n{request}")
+    ]).partial(format_instructions=parser.get_format_instructions())
+    date_str = datetime.date.today().isoformat()
+    logging.info(f"Extracting: {question}")
+    return await (prompt | llm | parser).ainvoke({
+        "request": question,
+        "current_date": date_str
+    })
+
+# 4. SEARCH HELPERS
+async def _cached_search(func, details):
+    key = (func.__name__, str(details))
+    if key in ttl_cache:
+        logging.info(f"Cache hit for {func.__name__}")
+        return ttl_cache[key]
+    logging.info(f"Cache miss for {func.__name__}")
+    res = await func(details)
+    ttl_cache[key] = res
+    return res
+
+async def _search_skyscanner(details: dict) -> list:
+    try:
+        logging.info(f"Skyscanner: {details['destination_city']}")
+        await asyncio.sleep(1)
+        return [{
+            "source": "Skyscanner",
+            "type": "flight",
+            "details": f"Round-trip to {details['destination_city']}",
+            "price": 800,
+            "link": "https://skyscanner.com"
+        }]
+    except Exception as e:
+        logging.error(e)
+        return []
+
+async def _search_expedia(details: dict) -> list:
+    try:
+        logging.info(f"Expedia: {details['destination_city']}")
+        await asyncio.sleep(1)
+        return [{
+            "source": "Expedia",
+            "type": "hotel",
+            "details": f"Hotel in {details['destination_city']}",
+            "price": 1200,
+            "link": "https://expedia.com"
+        }]
+    except Exception as e:
+        logging.error(e)
+        return []
+
+async def _search_getyourguide(details: dict) -> list:
+    try:
+        logging.info(f"GetYourGuide: {details['interests']}")
+        await asyncio.sleep(1)
+        return [{
+            "source": "GetYourGuide",
+            "type": "activity",
+            "details": f"Tour: {details['interests']}",
+            "price": 150,
+            "link": "https://getyourguide.com"
+        }]
+    except Exception as e:
+        logging.error(e)
+        return []
+
+# 5. GATHER ALL RESULTS
+async def _gather_travel_data(req: dict) -> list:
+    tasks = [
+        _cached_search(_search_skyscanner, req),
+        _cached_search(_search_expedia, req),
+        _cached_search(_search_getyourguide, req)
+    ]
+    results = await asyncio.gather(*tasks, return_exceptions=True)
+    combined = []
+    for r in results:
+        if isinstance(r, Exception):
+            logging.error(r)
+        else:
+            combined.extend(r)
+    return combined
+
+# 6. FORMAT OUTPUT
+def _format_response(req: dict, data: list) -> str:
+    dest = req['destination_city']
+    text = f"## Travel Plan for {dest}\n"
+    flights = [i for i in data if i['type']=='flight']
+    hotels = [i for i in data if i['type']=='hotel']
+    acts = [i for i in data if i['type']=='activity']
+    if flights:
+        text += "\n### Flights:\n"
+        for f in flights:
+            text += f"- {f['details']} (${f['price']}) [Book]({f['link']})\n"
+    if hotels:
+        text += "\n### Hotels:\n"
+        for h in hotels:
+            text += f"- {h['details']} (${h['price']}) [Book]({h['link']})\n"
+    if acts:
+        text += "\n### Activities:\n"
+        for a in acts:
+            text += f"- {a['details']} (${a['price']}) [Book]({a['link']})\n"
+    return text
+
+# 7. MAIN ORCHESTRATOR & UI
+async def ask_bot(question: str) -> str:
+    if not question:
+        return "Tell me your trip!"
+    try:
+        req = await _extract_user_request(question)
+        data = await _gather_travel_data(req)
+        return _format_response(req, data)
+    except Exception as e:
+        logging.error(e)
+        return "Error. Try again."
+
+iface = gr.Interface(
+    fn=ask_bot,
+    inputs=gr.Textbox(lines=4, label="Your dream trip?"),
+    outputs=gr.Markdown(),
+    title="AI Travel Bot"
+)
+
+if __name__ == "__main__":
+    iface.launch(server_name="0.0.0.0", server_port=7860)
+
+Click Commit changes to save and trigger build.
+
+7️⃣ Local Smoke Test (Catch Errors Early)
+
+On Windows Command Prompt:
+
+git clone https://huggingface.co/spaces/YOUR_USERNAME/WanderlustAI-v1
+cd WanderlustAI-v1
+copy .env.example .env
+# Open .env in Notepad and paste real keys
+pip install -r requirements.txt
+python app.py
+
+A browser window opens with your bot.
+
+Type e.g. "Cheap flight from NYC to Paris" → Submit.
+
+Check console: you should see INFO logs like "Extracting:" and "Skyscanner:".
+
+If it runs without errors, move to deployment.
+
+8️⃣ Deploy to Hugging Face
+
+git add .
+git commit -m "V1 ready"
+git push origin main
+
+In your Space on the web, click App tab.
+
+Wait ~60 seconds for build.
+
+Test live UI again.
+
+🎯 Roadmap to V2.0
+
+Split code into modules (extract.py, search.py, format.py).
+
+Write tests with pytest & vcrpy.
+
+Add retry/backoff examples using tenacity.
+
+Automate CI/CD with GitHub Actions.
+
+Congratulations! You've got every step—install, code, test, deploy—all in one place. Now build your AI Travel Bot! 🌍✨
+