Skip to content

Repository files navigation

Foreign Assiatant

Project Screenshot

A friendly web assistant for Indina Students studying Abroad, helping with vegetarian restaurant recommendations, easy single-pot recipes and phrase translations.
Built with ❤️ using React, TypeScript, and Gemini AI.


🛠️ Tech Stack

  • Frontend: React, TypeScript, Tailwind CSS
  • AI Integration: Gemini API (Google AI)
  • Deployment: Vercel

✨ Features

  • Vegetarian Restaurant Finder:
    Discover the best vegetarian and vegan restaurants near Students Campus or Residence.

  • Easy Single-Pot Recipes:
    Browse and view step-by-step recipes for Indian, Italian dishes.

  • Language Helper:
    Translate phrases between English and Mandarin Chinese (with Pinyin).

  • Conversational Chatbot:
    Friendly, helpful & feels like a family memnber, assistant for Students!


🧑‍💻 Getting Started

  1. Clone the repo:

    git clone https://github.com/yourusername/ForeignAssistant.git
    cd ForeignAssistant
  2. Install dependencies:

    npm install
  3. Set up environment variables:

    • Create a .env.local file in the root directory.
    • Add your Gemini API key:
      GEMINI_API_KEY=your-gemini-api-key
      
  4. Run the development server:

    npm run dev
  5. Open http://localhost:3000 to view the app.


📦 Deployment

This project is easily deployable on Vercel:

  • Push your code to GitHub.
  • Import your repo on Vercel.
  • Set the GEMINI_API_KEY environment variable in Vercel dashboard.
  • Deploy and share your live link!

🙏 Acknowledgements


📄 License

MIT License


About

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages