🌟 Transform your fashion discovery experience with AI-powered search that combines e-commerce platforms with real-time social media trends from Pinterest and Instagram!
Fash AI Agent is a revolutionary AI-powered fashion discovery platform that bridges the gap between traditional e-commerce search and social media fashion trends. Our intelligent agent searches across multiple platforms while learning from your preferences to deliver personalized fashion recommendations.
- 🔍 Fragmented Search: Fashion lovers waste time searching across multiple platforms
- 🤖 Generic Results: Traditional search engines don't understand fashion context
- 📱 Missed Trends: Social media fashion trends are hard to discover and track
- 🎯 No Personalization: Current solutions don't learn from user preferences
A unified AI agent that combines e-commerce search, social media trends, and personalized recommendations in one powerful platform.
|
|
|
|
| Feature | Description | Status |
|---|---|---|
| 📌 Pinterest Integration | Real-time fashion trends and style inspiration | ✅ Complete |
| 📸 Instagram Scraping | Fashion hashtags and influencer content | ✅ Complete |
| 🤖 Personalized Recommendations | AI learns from user feedback and preferences | ✅ Complete |
| 📊 User Feedback System | Interactive like/save/view tracking | ✅ Complete |
| 🌐 Enhanced Web Interface | Beautiful UI with social media integration | ✅ Complete |
| 📈 Trend Analysis | Seasonal trends and brand popularity tracking | ✅ Complete |
 |
 |
 |
 |
 |
 |
 |
 |
# Check Python version (3.8+ required)
python --version
# Ensure you have Git installed
git --version# Clone the repository
git clone https://github.com/Sunzzx/fash-ai-agent.git
cd fash-ai-agent
# Create virtual environment
python -m venv venv
# Activate virtual environment
# Windows:
venv\Scripts\activate
# macOS/Linux:
source venv/bin/activate# Install required packages
pip install -r requirements.txt
# Verify installation
pip list | grep -E "(openai|flask|beautifulsoup4|selenium)"# Copy environment template
cp .env.example .env
# Edit .env file with your API keys
nano .env # or use your preferred editorRequired API Keys:
# OpenAI for AI-powered search
OPENAI_API_KEY=your_openai_api_key_here
# SERP API for enhanced search
SERP_API_KEY=your_serp_api_key_here
# Email configuration (optional)
EMAIL_HOST=smtp.gmail.com
EMAIL_PORT=587
EMAIL_USER=your_email@gmail.com
EMAIL_PASSWORD=your_app_password🌐 Web Interface
python web_interface.py
# Access at http://localhost:5000⚡ Command Line Interface
python main.py --help🎯 Interactive Mode
python main.py
# Follow the interactive prompts# Simple clothing search
python main.py --query "blue denim jacket under $100"
# Search with social media trends
python main.py --query "summer dress" --social-media
# Get personalized recommendations
python main.py --query "sneakers" --user-session "user123"# Get current fashion trends
python main.py --trending
# Seasonal trend analysis
python main.py --season summer
# Style inspiration search
python main.py --inspiration "vintage,bohemian,minimalist"# Start interactive mode
python main.py
# Available commands:
👗 Search: blue summer dress size M
👗 Search: trending
👗 Search: inspiration: streetwear minimalist
👗 Search: help
👗 Search: quit| Feature | Description |
|---|---|
| 🔍 Smart Search | AI-powered natural language search |
| 📊 Trend Dashboard | Real-time social media trends |
| ❤️ Interactive Feedback | Like, save, and rate items |
| 📈 Personal Analytics | Track your fashion preferences |
| 🎨 Style Inspiration | Discover new fashion styles |
fash-ai-agent/
├── 🎯 main.py # Main CLI entry point
├── 🤖 clothing_agent.py # Core AI agent logic
├── 👕 clothing_item.py # Data models for clothing items
├── ⚙️ settings.py # Configuration management
├── 🔧 filter_agent.py # Advanced filtering and ranking
├── 📱 web_interface.py # Flask web application
├── 📌 pinterest_scraper.py # Pinterest content scraper
├── 📸 instagram_scraper.py # Instagram content scraper
├── 📊 social_media_manager.py # Social media integration hub
├── 💬 user_feedback.py # User interaction tracking
├── 📝 preferences.py # User preference models
├── 📋 logger.py # Application logging
├── 🌐 templates/ # Web interface templates
│ └── index.html # Main UI template
├── 📚 docs/ # Documentation
├── 🧪 tests/ # Test suite
└── 📦 requirements.txt # Dependencies
# Run all tests
pytest
# Run with coverage report
pytest --cov=src tests/
# Run specific test categories
pytest tests/test_agents/
pytest tests/test_scrapers/
pytest tests/test_social_media/# Format code with Black
black .
# Lint with flake8
flake8 src/
# Type checking with mypy
mypy src/- Response Time: < 2s for basic searches
- Social Media Integration: < 5s for trend analysis
- Memory Usage: Optimized for low resource consumption
- Rate Limiting: Respectful API usage patterns
- 🍴 Fork the repository
- 🌿 Create a feature branch:
git checkout -b feature/amazing-feature - 💻 Code your changes following our style guide
- ✅ Test your changes:
pytest - 📝 Commit with clear messages:
git commit -m "feat: add amazing feature" - 🚀 Push to your fork:
git push origin feature/amazing-feature - 📬 Submit a Pull Request
| Area | Description | Difficulty |
|---|---|---|
| 🛍️ New E-commerce Scrapers | Add support for more shopping platforms | 🟢 Beginner |
| 📱 Social Media Platforms | Integrate TikTok, Twitter, YouTube | 🟡 Intermediate |
| 🤖 AI Improvements | Enhance recommendation algorithms | 🔴 Advanced |
| 🌐 UI/UX Enhancements | Improve web interface design | 🟡 Intermediate |
| 📊 Analytics Features | Add trend prediction and analytics | 🔴 Advanced |
| Document | Description |
|---|---|
| 📖 Contributing Guide | How to contribute to the project |
| 🔐 Code of Conduct | Community guidelines and standards |
| 🚀 API Documentation | Complete API reference |
| 📱 Social Media Integration | Detailed feature documentation |
| 🐛 Issue Templates | Bug reports and feature requests |
- Local Storage: User data stored locally in SQLite
- No Personal Info: No personal information collected
- Session-Based: Temporary session tracking only
- API Security: Secure handling of API keys
- Rate Limiting: Respectful API usage
- Robots.txt Compliance: Follows web scraping ethics
- Caching: Minimizes redundant requests
- Error Handling: Graceful failure management
| Quarter | Features | Status |
|---|---|---|
| Q2 2024 | 🔥 TikTok Integration, 📊 Advanced Analytics | 🟡 In Progress |
| Q3 2024 | 📱 Mobile App, 🤖 ML Improvements | 📅 Planned |
| Q4 2024 | 🌍 Multi-language Support, 💳 Price Alerts | 📅 Planned |
| Q1 2025 | 🎨 AR Try-on, 🤖 Voice Search | 💭 Research |
Love Fash AI Agent? Show your support!
Special thanks to our amazing contributors and the open-source community!
- GirlScript Summer of Code 2025 - Open source program
- OpenAI - AI-powered search capabilities
- Flask - Web framework
- BeautifulSoup - Web scraping
This project is licensed under the MIT License - see the LICENSE file for details.
🎉 Happy Fashion Hunting! 🛍️
