jainsandesh960/symptomap-ai

🌿 SymptoMap.ai

Your Calm Companion for Understanding Body Sensations

SymptoMap.ai is a wellness education web application that helps users understand everyday body sensations in a calm, educational way. It provides general wellness information without diagnosis or medical advice.

⚠️ Important Disclaimer

SymptoMap.ai is NOT a medical device, diagnostic tool, or healthcare provider.

This application provides general educational information only and should NEVER be used as a substitute for professional medical advice, diagnosis, or treatment. Always consult with qualified healthcare professionals for any health concerns.

✨ Features

• —📝 Sensation Input Form - Describe your experience with structured fields
• —🤖 AI-Powered Insights - Get calm, educational explanations using Google Gemini
• —🧍 Interactive Body Map - Visual highlighting of affected body regions
• —📊 Session History - Track past sensations with timestamps
• —🌙 Dark Mode - Toggle between light and dark themes
• —💾 Export Function - Download your wellness insights as markdown
• —📈 Intensity Trends - Visual chart of intensity over time
• —🧘 Breathing Exercise - Quick calming exercise widget
• —📱 Mobile Responsive - Works on all devices
• —🔒 Safety First - Built-in filters prevent medical claims

🛠️ Tech Stack

• —Frontend: Streamlit
• —AI: Google Gemini Flash API
• —Language: Python 3.9+
• —Styling: Custom CSS with premium design system

🚀 Quick Start

Prerequisites

• —Python 3.9 or higher
• —Google API Key (Gemini)

Installation

1. 1.Clone the repository

   git clone <repository-url>
   cd symptomap_ai

1. 1.Create a virtual environment

   python -m venv venv
   source venv/bin/activate  # On Windows: venv\Scripts\activate

1. 1.Install dependencies

   pip install -r requirements.txt

1. 1.Configure environment variables

   cp .env.example .env
   # Edit .env and add your GOOGLE_API_KEY

1. 1.Run the application

   streamlit run app.py

1. 1.Open in browser Navigate to http://localhost:8501

📁 Project Structure

symptomap_ai/
├── app.py                 # Main application entry point
├── requirements.txt       # Python dependencies
├── .env.example          # Environment template
├── README.md             # This file
│
├── page_modules/         # Page modules
│   ├── __init__.py
│   ├── home.py          # Main input/analysis page
│   ├── about.py         # About page
│   └── safety.py        # Safety & disclaimer page
│
├── utils/                # Utility modules
│   ├── __init__.py
│   ├── llm_client.py    # Google Gemini API client
│   ├── prompts.py       # Prompt templates
│   ├── response_safety.py  # Response sanitization
│   ├── body_map.py      # Body region management
│   └── ui_components.py # Reusable UI components
│
├── assets/              # Static assets
│   └── styles.css       # Custom CSS styles
│
└── .streamlit/          # Streamlit configuration
    └── config.toml

🔒 Safety Features

SymptoMap.ai includes multiple layers of safety:

1. 1.System Prompt Engineering - AI is instructed to never diagnose or use medical terminology
2. 2.Response Sanitization - Post-processing filters remove:
3. 3.Medical terms and disease names
4. 4.Percentages and statistics
5. 5.Diagnostic phrases
6. 6.Mandatory Disclaimers - Every response includes safety reminders
7. 7.Fallback Responses - Safe generic responses if AI fails
8. 8.Emergency Guidance - Clear (non-diagnostic) emergency information

🎨 Customization

Themes

Edit .streamlit/config.toml to customize colors:

[theme]
primaryColor = "#4A90A4"
backgroundColor = "#F8FBFC"
secondaryBackgroundColor = "#EEF5F8"
textColor = "#2C3E50"

Adding Body Regions

Edit utils/body_map.py to add new body regions:

BODY_REGIONS["New Region"] = {
    "keywords": ["keyword1", "keyword2"],
    "color": "#HEXCOLOR",
    "icon": "🆕",
    "svg_id": "new_region"
}

📝 API Configuration

Getting a Google API Key

1. 1.Go to Google AI Studio
2. 2.Click "Create API Key"
3. 3.Copy the key and add it to your .env file

Rate Limiting

The application includes built-in rate limiting (1 second minimum between requests) to avoid API quota issues.

🧪 Development

Running in Development Mode

streamlit run app.py --server.runOnSave true

Code Quality

The codebase follows:

• —PEP 8 style guidelines
• —Type hints where appropriate
• —Comprehensive docstrings
• —Modular architecture

📄 License

MIT License - See LICENSE file for details.

🤝 Contributing

Contributions are welcome! Please ensure:

• —Code follows existing style
• —Safety features are maintained
• —No medical claims or diagnostic language
• —All new features include proper disclaimers

📞 Support

For questions or issues, please open a GitHub issue.

Remember: SymptoMap.ai is for educational purposes only. Always consult healthcare professionals for medical concerns.

🌿 Understanding your body, one sensation at a time.