Skip to content

OjaswiJoshi13/PocketDoc

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

10 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🩺 PocketDoc – AI Health Companion

PocketDoc is an AI-powered health chatbot built with Next.js and integrated with the Groq API using LLaMA3 models. It helps users get instant answers to health-related questions, and even helps locate nearby doctors using geolocation.

🌐 Live Demo

πŸ”— Visit the site here


βš™οΈ Features

  • πŸ€– Real-time AI health assistant
  • πŸ“ β€œFind Nearby Doctors” using Geolocation (opens in Google Maps)
  • 🎨 Beautiful, responsive UI with animations
  • πŸ”’ Only responds to medical queries
  • ☁️ Deployed on Vercel with secure environment variables

🧠 Powered By


πŸ› οΈ Getting Started

1. Clone the Repo

git clone https://github.com/your-username/pocketdoc.git
cd pocketdoc

2. Install Dependencies

npm install
# or
yarn install

3. Add Environment Variables

NEXT_PUBLIC_GROQ_API_KEY=your_groq_api_key_here
NEXT_PUBLIC_MAP_API_KEY=your_google_maps_api_key_here

4. Run the Development Server

npm run dev

πŸ—‚οΈ Project Structure

pocketdoc/
β”œβ”€β”€ app/                 # Next.js App Router pages and layouts
β”‚   β”œβ”€β”€ page.tsx         # Main chat interface
β”‚   β”œβ”€β”€ components/      # UI components (chat box, navbar, etc.)
β”‚   β”œβ”€β”€ utils/           # Helper and API utility functions
β”‚   └── styles/          # Global and component styles
β”œβ”€β”€ public/              # Static assets (icons, logos)
β”œβ”€β”€ .env.local           # Environment variables
β”œβ”€β”€ package.json         # Dependencies and scripts
β”œβ”€β”€ next.config.ts       # Next.js configuration
β”œβ”€β”€ tailwind.config.mjs  # TailwindCSS configuration
└── tsconfig.json        # TypeScript configuration

🧩 Scripts

Command Description
npm run dev Starts the app in development mode
npm run build Builds the production version
npm start Runs the built app
npm run lint Runs Next.js linting

🌍 Deployment

PocketDoc is fully deployable on Vercel.

  1. Push your project to a GitHub repository.
  2. Visit Vercel and import your repo.
  3. Add your .env variables in Vercel’s dashboard under Settings β†’ Environment Variables.
  4. Click Deploy β€” and you’re live!

🧠 How It Works

  • Users interact with an AI-powered chatbot that only responds to medical-related queries.
  • The app uses Groq API (LLaMA 3) to process user questions and generate safe responses.
  • The Geolocation feature lets users find nearby doctors by opening Google Maps at their current location.
  • A clean TailwindCSS interface with animations ensures smooth user experience.

πŸ§‘β€πŸ’» Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature-name)
  3. Commit your changes (git commit -m "Add feature")
  4. Push to your branch (git push origin feature-name)
  5. Open a Pull Request

πŸͺͺ License

This project is licensed under the MIT License.
You are free to use, modify, and distribute it β€” just give proper credit.

About

🩺 PocketDoc – Your AI Health Companion An intelligent chatbot powered by Groq’s LLaMA3 model that provides instant answers to health-related questions and helps you find nearby doctors using geolocation. Built with Next.js, TailwindCSS, and deployed on Vercel.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors