abawu/explore-eth

ethiopian AI tour guide # Eth Explore Eth Explore is a polished React travel guide for Ethiopia. It presents an image-led hero, culture-aware prompt starters, and a streaming chat interface designed for planning food, history, festivals, layovers, and respectful local experiences. ## Run locally ```bash npm install npm run dev ``` ## AI setup The app uses a private serverless API route at `api/chat.ts` to call Hugging Face. Add these environment variables in your hosting platform: ```bash HF_TOKEN=your_hugging_face_token HF_MODEL=Qwen/Qwen2.5-7B-Instruct ``` `HF_MODEL` is optional. If it is not set, the app uses `Qwen/Qwen2.5-7B-Instruct`. If the Hugging Face route is unavailable or `HF_TOKEN` is missing, the frontend automatically falls back to a no-key MVP mode powered by Pollinations. ## Scripts - `npm run dev` starts the Vite dev server. - `npm run build` creates a production build in `dist`. - `npm run typecheck` runs TypeScript without emitting files. ## API contract The frontend calls: ```text POST /api/chat ``` Request body: ```json { "messages": [ { "role": "user", "content": "Plan one day in Addis Ababa" } ] } ``` Response body: ```json { "provider": "huggingface", "model": "Qwen/Qwen2.5-7B-Instruct", "content": "..." } ```