Skip to content

LincolnNE/Drug-Interaction-Checker

ย 
ย 

Repository files navigation

๐Ÿ’Š Drug Interaction Checker

Professional drug interaction analysis with AI-powered insights and intelligent search capabilities

๐Ÿ‡บ๐Ÿ‡ธ English | ๐Ÿ‡ฐ๐Ÿ‡ท ํ•œ๊ตญ์–ด


English

๐ŸŒŸ Overview

Drug Interaction Checker is a sophisticated web application that helps users identify potential interactions between medications. Combining FDA data with advanced AI analysis from multiple providers, it offers comprehensive drug safety information with an intuitive, modern interface.

โœจ Key Features

๐Ÿ” Intelligent Search Engine

  • Real-time search with 300ms debounce
  • Typo tolerance and fuzzy matching
  • Partial search capabilities (e.g., "aspir" โ†’ "Aspirin")
  • Korean-English mixed usage support
  • Relevance-based sorting with similarity algorithms

๐Ÿค– Multi-AI Analysis

  • Support for 4 major AI services: OpenAI, Claude, Perplexity, Gemini
  • Professional medical analysis with structured reports
  • Risk assessment: Low/Moderate/High/Very High
  • Clinical recommendations and emergency signs
  • Auto-fallback system for failed connections

๐Ÿ“Š Comprehensive Data

  • FDA OpenFDA API integration
  • 50+ drug database with brand names
  • Detailed drug information with manufacturer details
  • Interaction mechanisms and warnings
  • Recent search history and favorites

๐ŸŽจ Modern UI/UX

  • Glassmorphism design with blur effects
  • Monochrome theme (black/white professional look)
  • Dark/Light mode support
  • Responsive design for all devices
  • Accessibility features with ARIA labels

๐Ÿ›  Technology Stack

  • Frontend: HTML5, CSS3, JavaScript (ES6+)
  • APIs: FDA OpenFDA, OpenAI, Anthropic Claude, Perplexity, Google Gemini
  • Design: CSS Grid/Flexbox, Glassmorphism effects
  • Features: Real-time search, AI integration, Local storage

๐Ÿš€ Getting Started

๐ŸŒ Language Support

  • Korean (Default): index.html - ํ•œ๊ตญ์–ด ๋ฉ”์ธ ํŽ˜์ด์ง€
  • English: index_en.html - ์˜์–ด ๋ฒ„์ „
  • Language Switch: Click the language button in the header to switch between Korean and English

Prerequisites

  • Modern web browser (Chrome, Firefox, Safari, Edge)
  • Internet connection for API access
  • At least one AI API key (optional but recommended)

Installation

  1. Clone the repository

    git clone https://github.com/yourusername/drug-interaction-checker.git
    cd drug-interaction-checker
  2. Open in browser

    # Simply open index.html in your browser
    open index.html
    # or
    python -m http.server 8000  # For local server
  3. Configure AI APIs (Optional)

    • Click the โš™๏ธ settings button
    • Add your API keys for desired services
    • Test connections using the ๐Ÿงช API Test button

API Key Setup

OpenAI (Recommended)
  1. Visit OpenAI Platform
  2. Create an account and generate API key
  3. Format: sk-...
Anthropic Claude
  1. Visit Anthropic Console
  2. Generate API key
  3. Format: sk-ant-...
Perplexity AI
  1. Visit Perplexity Settings
  2. Generate API key
  3. Format: pplx-...
Google Gemini
  1. Visit Google AI Studio
  2. Generate API key
  3. Format: AI...

๐Ÿ“– Usage

  1. Search for drugs

    • Type drug name in the search box
    • Use partial names or even typos
    • Select from intelligent suggestions
  2. Check interactions

    • Choose two drugs from dropdowns
    • Click "Check Interaction"
    • Review both AI analysis and FDA data
  3. View detailed information

    • Click on any drug name for detailed info
    • Add drugs directly to interaction checker

๐Ÿ”ฌ AI Analysis Features

  • Risk Assessment: Comprehensive risk level evaluation
  • Clinical Insights: Professional medical recommendations
  • Interaction Mechanisms: How drugs interact at molecular level
  • Emergency Signs: When to seek immediate medical attention
  • Structured Reports: Easy-to-read formatted analysis

โš ๏ธ Important Medical Disclaimer

This tool is for informational purposes only and should not replace professional medical advice. Always consult with healthcare providers before making medication decisions.

๐Ÿค Contributing

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

๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

๐Ÿ™ Acknowledgments

  • FDA OpenFDA for comprehensive drug data
  • AI providers for advanced analysis capabilities
  • Medical professionals for guidance on drug interactions

Korean

๐ŸŒŸ ๊ฐœ์š”

์•ฝ๋ฌผ ์ƒํ˜ธ์ž‘์šฉ ์ฒด์ปค๋Š” ์˜์•ฝํ’ˆ ๊ฐ„์˜ ์ž ์žฌ์  ์ƒํ˜ธ์ž‘์šฉ์„ ์‹๋ณ„ํ•˜๋Š” ๋ฐ ๋„์›€์„ ์ฃผ๋Š” ์ •๊ตํ•œ ์›น ์• ํ”Œ๋ฆฌ์ผ€์ด์…˜์ž…๋‹ˆ๋‹ค. FDA ๋ฐ์ดํ„ฐ์™€ ์—ฌ๋Ÿฌ AI ์ œ๊ณต์—…์ฒด์˜ ๊ณ ๊ธ‰ ๋ถ„์„์„ ๊ฒฐํ•ฉํ•˜์—ฌ ์ง๊ด€์ ์ด๊ณ  ํ˜„๋Œ€์ ์ธ ์ธํ„ฐํŽ˜์ด์Šค๋กœ ํฌ๊ด„์ ์ธ ์•ฝ๋ฌผ ์•ˆ์ „ ์ •๋ณด๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค.

โœจ ์ฃผ์š” ๊ธฐ๋Šฅ

๐Ÿ” ์ง€๋Šฅํ˜• ๊ฒ€์ƒ‰ ์—”์ง„

  • ์‹ค์‹œ๊ฐ„ ๊ฒ€์ƒ‰ (300ms;0.3์ดˆ ๋””๋ฐ”์šด์Šค)
  • ์˜คํƒ€ ํ—ˆ์šฉ ๋ฐ ํผ์ง€ ๋งค์นญ
  • ๋ถ€๋ถ„ ๊ฒ€์ƒ‰ ๊ธฐ๋Šฅ (์˜ˆ: "์•„์ŠคํŒŒ" โ†’ "์•„์Šคํ”ผ๋ฆฐ")
  • ํ•œ๊ตญ์–ด-์˜์–ด ํ˜ผ์šฉ ์ง€์›
  • ๊ด€๋ จ๋„ ๊ธฐ๋ฐ˜ ์ •๋ ฌ ๋ฐ ์œ ์‚ฌ๋„ ์•Œ๊ณ ๋ฆฌ์ฆ˜

๐Ÿค– ๋‹ค์ค‘ AI ๋ถ„์„

  • 4๊ฐœ ์ฃผ์š” AI ์„œ๋น„์Šค ์ง€์›: OpenAI, Claude, Perplexity, Gemini
  • ์ „๋ฌธ ์˜๋ฃŒ ๋ถ„์„ ๋ฐ ๊ตฌ์กฐํ™”๋œ ๋ณด๊ณ ์„œ
  • ์œ„ํ—˜๋„ ํ‰๊ฐ€: ๋‚ฎ์Œ/๋ณดํ†ต/๋†’์Œ/๋งค์šฐ ๋†’์Œ
  • ์ž„์ƒ ๊ถŒ์žฅ์‚ฌํ•ญ ๋ฐ ์‘๊ธ‰ ์ง•ํ›„
  • ์—ฐ๊ฒฐ ์‹คํŒจ ์‹œ ์ž๋™ ๋Œ€์ฒด ์‹œ์Šคํ…œ

๐Ÿ“Š ํฌ๊ด„์  ๋ฐ์ดํ„ฐ

  • FDA OpenFDA API ํ†ตํ•ฉ
  • 50+ ์•ฝ๋ฌผ ๋ฐ์ดํ„ฐ๋ฒ ์ด์Šค (๋ธŒ๋žœ๋“œ๋ช… ํฌํ•จ)
  • ์ƒ์„ธ ์•ฝ๋ฌผ ์ •๋ณด ๋ฐ ์ œ์กฐ์‚ฌ ์ •๋ณด
  • ์ƒํ˜ธ์ž‘์šฉ ๋ฉ”์ปค๋‹ˆ์ฆ˜ ๋ฐ ๊ฒฝ๊ณ 
  • ์ตœ๊ทผ ๊ฒ€์ƒ‰ ๊ธฐ๋ก ๋ฐ ์ฆ๊ฒจ์ฐพ๊ธฐ

๐ŸŽจ ๋ชจ๋˜ UI/UX

  • ๊ธ€๋ž˜์Šค๋ชจํ”ผ์ฆ˜ ๋””์ž์ธ (๋ธ”๋Ÿฌ ํšจ๊ณผ)
  • ๋ชจ๋…ธํฌ๋กฌ ํ…Œ๋งˆ (ํ‘๋ฐฑ ์ „๋ฌธ๊ฐ€ ๋ฃฉ)
  • ๋‹คํฌ/๋ผ์ดํŠธ ๋ชจ๋“œ ์ง€์›
  • ๋ฐ˜์‘ํ˜• ๋””์ž์ธ (๋ชจ๋“  ๊ธฐ๊ธฐ ์ง€์›)
  • ์ ‘๊ทผ์„ฑ ๊ธฐ๋Šฅ (ARIA ๋ผ๋ฒจ)

๐Ÿ›  ๊ธฐ์ˆ  ์Šคํƒ

  • ํ”„๋ก ํŠธ์—”๋“œ: HTML5, CSS3, JavaScript (ES6+)
  • API: FDA OpenFDA, OpenAI, Anthropic Claude, Perplexity, Google Gemini
  • ๋””์ž์ธ: CSS Grid/Flexbox, ๊ธ€๋ž˜์Šค๋ชจํ”ผ์ฆ˜ ํšจ๊ณผ
  • ๊ธฐ๋Šฅ: ์‹ค์‹œ๊ฐ„ ๊ฒ€์ƒ‰, AI ํ†ตํ•ฉ, ๋กœ์ปฌ ์Šคํ† ๋ฆฌ์ง€

๐Ÿš€ ์‹œ์ž‘ํ•˜๊ธฐ

๐ŸŒ ์–ธ์–ด ์ง€์›

  • ํ•œ๊ตญ์–ด (๊ธฐ๋ณธ): index.html - ํ•œ๊ตญ์–ด ๋ฉ”์ธ ํŽ˜์ด์ง€
  • ์˜์–ด: index_en.html - ์˜์–ด ๋ฒ„์ „
  • ์–ธ์–ด ์ „ํ™˜: ํ—ค๋”์˜ ์–ธ์–ด ๋ฒ„ํŠผ์„ ํด๋ฆญํ•˜์—ฌ ํ•œ๊ตญ์–ด์™€ ์˜์–ด ๊ฐ„ ์ „ํ™˜

์‚ฌ์ „ ์š”๊ตฌ์‚ฌํ•ญ

  • ๋ชจ๋˜ ์›น ๋ธŒ๋ผ์šฐ์ € (Chrome, Firefox, Safari, Edge)
  • API ์ ‘๊ทผ์„ ์œ„ํ•œ ์ธํ„ฐ๋„ท ์—ฐ๊ฒฐ
  • ์ตœ์†Œ ํ•˜๋‚˜์˜ AI API ํ‚ค (์„ ํƒ์‚ฌํ•ญ์ด์ง€๋งŒ ๊ถŒ์žฅ)

์„ค์น˜

  1. ์ €์žฅ์†Œ ๋ณต์ œ

    git clone https://github.com/yourusername/drug-interaction-checker.git
    cd drug-interaction-checker
  2. ๋ธŒ๋ผ์šฐ์ €์—์„œ ์—ด๊ธฐ

    # ๋ธŒ๋ผ์šฐ์ €์—์„œ index.html ์—ด๊ธฐ
    open index.html
    # ๋˜๋Š”
    python -m http.server 8000  # ๋กœ์ปฌ ์„œ๋ฒ„์šฉ
  3. AI API ๊ตฌ์„ฑ (์„ ํƒ์‚ฌํ•ญ)

    • โš™๏ธ ์„ค์ • ๋ฒ„ํŠผ ํด๋ฆญ
    • ์›ํ•˜๋Š” ์„œ๋น„์Šค์˜ API ํ‚ค ์ถ”๊ฐ€
    • ๐Ÿงช API ํ…Œ์ŠคํŠธ ๋ฒ„ํŠผ์œผ๋กœ ์—ฐ๊ฒฐ ํ™•์ธ

API ํ‚ค ์„ค์ •

OpenAI (๊ถŒ์žฅ)
  1. OpenAI ํ”Œ๋žซํผ ๋ฐฉ๋ฌธ
  2. ๊ณ„์ • ์ƒ์„ฑ ํ›„ API ํ‚ค ์ƒ์„ฑ
  3. ํ˜•์‹: sk-...
Anthropic Claude
  1. Anthropic ์ฝ˜์†” ๋ฐฉ๋ฌธ
  2. API ํ‚ค ์ƒ์„ฑ
  3. ํ˜•์‹: sk-ant-...
Perplexity AI
  1. Perplexity ์„ค์ • ๋ฐฉ๋ฌธ
  2. API ํ‚ค ์ƒ์„ฑ
  3. ํ˜•์‹: pplx-...
Google Gemini
  1. Google AI Studio ๋ฐฉ๋ฌธ
  2. API ํ‚ค ์ƒ์„ฑ
  3. ํ˜•์‹: AI...

๐Ÿ“– ์‚ฌ์šฉ๋ฒ•

  1. ์•ฝ๋ฌผ ๊ฒ€์ƒ‰

    • ๊ฒ€์ƒ‰์ฐฝ์— ์•ฝ๋ฌผ๋ช… ์ž…๋ ฅ
    • ๋ถ€๋ถ„ ์ด๋ฆ„์ด๋‚˜ ์˜คํƒ€๋„ ๊ฐ€๋Šฅ
    • ์ง€๋Šฅํ˜• ์ œ์•ˆ์—์„œ ์„ ํƒ
  2. ์ƒํ˜ธ์ž‘์šฉ ํ™•์ธ

    • ๋“œ๋กญ๋‹ค์šด์—์„œ ๋‘ ์•ฝ๋ฌผ ์„ ํƒ
    • "์ƒํ˜ธ์ž‘์šฉ ํ™•์ธ" ํด๋ฆญ
    • AI ๋ถ„์„๊ณผ FDA ๋ฐ์ดํ„ฐ ๋ชจ๋‘ ๊ฒ€ํ† 
  3. ์ƒ์„ธ ์ •๋ณด ๋ณด๊ธฐ

    • ์•ฝ๋ฌผ๋ช… ํด๋ฆญํ•˜์—ฌ ์ƒ์„ธ ์ •๋ณด ํ™•์ธ
    • ์ƒํ˜ธ์ž‘์šฉ ์ฒด์ปค์— ์ง์ ‘ ์•ฝ๋ฌผ ์ถ”๊ฐ€

๐Ÿ”ฌ AI ๋ถ„์„ ๊ธฐ๋Šฅ

  • ์œ„ํ—˜๋„ ํ‰๊ฐ€: ํฌ๊ด„์ ์ธ ์œ„ํ—˜ ์ˆ˜์ค€ ํ‰๊ฐ€
  • ์ž„์ƒ ํ†ต์ฐฐ: ์ „๋ฌธ ์˜๋ฃŒ ๊ถŒ์žฅ์‚ฌํ•ญ
  • ์ƒํ˜ธ์ž‘์šฉ ๋ฉ”์ปค๋‹ˆ์ฆ˜: ๋ถ„์ž ์ˆ˜์ค€์—์„œ์˜ ์•ฝ๋ฌผ ์ƒํ˜ธ์ž‘์šฉ
  • ์‘๊ธ‰ ์ง•ํ›„: ์ฆ‰์‹œ ์˜๋ฃŒ์ง„ ๋„์›€์ด ํ•„์š”ํ•œ ๊ฒฝ์šฐ
  • ๊ตฌ์กฐํ™”๋œ ๋ณด๊ณ ์„œ: ์ฝ๊ธฐ ์‰ฌ์šด ํ˜•์‹์˜ ๋ถ„์„

โš ๏ธ ์ค‘์š”ํ•œ ์˜๋ฃŒ ๋ฉด์ฑ…์กฐํ•ญ

์ด ๋„๊ตฌ๋Š” ์ •๋ณด ์ œ๊ณต ๋ชฉ์ ์œผ๋กœ๋งŒ ์‚ฌ์šฉ๋˜๋ฉฐ ์ „๋ฌธ ์˜๋ฃŒ ์กฐ์–ธ์„ ๋Œ€์ฒดํ•  ์ˆ˜ ์—†์Šต๋‹ˆ๋‹ค. ์•ฝ๋ฌผ ๊ด€๋ จ ๊ฒฐ์ •์„ ๋‚ด๋ฆฌ๊ธฐ ์ „์— ํ•ญ์ƒ ์˜๋ฃŒ์ง„๊ณผ ์ƒ๋‹ดํ•˜์‹ญ์‹œ์˜ค.

๐Ÿค ๊ธฐ์—ฌํ•˜๊ธฐ

  1. ์ €์žฅ์†Œ ํฌํฌ
  2. ๊ธฐ๋Šฅ ๋ธŒ๋žœ์น˜ ์ƒ์„ฑ (git checkout -b feature/amazing-feature)
  3. ๋ณ€๊ฒฝ์‚ฌํ•ญ ์ปค๋ฐ‹ (git commit -m 'Add amazing feature')
  4. ๋ธŒ๋žœ์น˜์— ํ‘ธ์‹œ (git push origin feature/amazing-feature)
  5. Pull Request ์ƒ์„ฑ

๐Ÿ“„ ๋ผ์ด์„ ์Šค

์ด ํ”„๋กœ์ ํŠธ๋Š” MIT ๋ผ์ด์„ ์Šค ํ•˜์— ์žˆ์Šต๋‹ˆ๋‹ค. ์ž์„ธํ•œ ๋‚ด์šฉ์€ LICENSE ํŒŒ์ผ์„ ์ฐธ์กฐํ•˜์„ธ์š”.

๐Ÿ™ ๊ฐ์‚ฌ์˜ ๋ง

  • ํฌ๊ด„์ ์ธ ์•ฝ๋ฌผ ๋ฐ์ดํ„ฐ๋ฅผ ์ œ๊ณตํ•˜๋Š” FDA OpenFDA(์‹์•ฝ์ฒ˜์˜ api๋กœ ๋Œ€์ฒดํ•  ์˜ˆ์ •)
  • ๊ณ ๊ธ‰ ๋ถ„์„ ๊ธฐ๋Šฅ์„ ์ œ๊ณตํ•˜๋Š” AI ์„œ๋น„์Šค ์ œ๊ณต์—…์ฒด๋“ค
  • ์•ฝ๋ฌผ ์ƒํ˜ธ์ž‘์šฉ์— ๋Œ€ํ•œ ์ง€์นจ์„ ์ œ๊ณตํ•œ ์˜๋ฃŒ ์ „๋ฌธ๊ฐ€๋“ค

About

G.gear service delta team

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • JavaScript 64.7%
  • CSS 28.1%
  • HTML 7.2%