- Install Dependencies
pip install -r requirements.txt- Run the FastAPI
python -m app.main- Run web server (in another terminal)
cd web/
python -m http.server 3000- Open in Browser
- Visit: http://localhost:8000 for API docs
- Visit: http://localhost:3000 for Web App
- The app works great on mobile browsers too!
- Add Product to Your Routine: Select product and add
- Add Custom Ingredients: Enter ingredient names like "Niacinamide, Retinol"
- Check Interactions: Find ingredient clashes, synergies, and cautions
- Calculate Scores: See how your routine scores across different categories
- Select a treatment (Microneedling or Chemical Peel)
- See which products to avoid and for how long
✅ Mobile-First Design: Works perfectly on phones
✅ Real-Time Analysis: Instant feedback on ingredient interactions
✅ Treatment Safety: Post-procedure product recommendations
✅ Scoring System: Quantified routine effectiveness
✅ Custom Ingredients: Add ingredients not in products
GET /- Main web interfacePOST /{routine_id}/analyze/interactions- Analyze ingredient interactionsPOST /{routine_id}/analyze/score- Calculate routine scoresPOST /{routine_id}/analyze/post-treatment- Post-treatment analysisGET /api/products- List all productsGET /api/ingredients- List all ingredients
- User Authentication: Add user accounts and saved routines
- Database: Move from CSV to PostgreSQL/SQLite
- AI Chat: Add OpenAI integration for conversational analysis
- Push Notifications: Treatment reminders and routine suggestions
- Data Logging: Track skin changes over time
- Camera Integration: Skin photo analysis
- Native Mobile App: React Native or Flutter client
The app uses your existing CSV structure:
ingredients.csv- Ingredient databaseproducts.csv- Product catalogproduct_ingredients.csv- Product-ingredient relationshipsinteractions.csv- Ingredient interaction rulestreatments.csv- Available treatmentstreatment_rules.csv- Post-treatment safety rules
Try these example routines:
- Product 1 + 3: Should show retinol/vitamin C clash
- Product 1 + 2: Good synergy between niacinamide and ceramides
- Custom: "Salicylic Acid, Niacinamide" for acne routine