Skip to content

AnvitaPrasad/AgenticAIChatbot-AnvitaPrasad

Repository files navigation

👗 AIris - AI-Powered Fashion Advisor

Python Gradio FastAPI Code style: black License: MIT

Demo | Documentation | Architecture


Your intelligent fashion companion powered by AI 🤖✨

🌟 Overview

AIris is an intelligent fashion advisory system that leverages Large Language Models (LLMs) and computer vision to provide personalized style recommendations. Built with modern AI technologies, it demonstrates practical applications of artificial intelligence in the fashion domain.

AIris Architecture

AIris System Architecture

✨ Key Features

  • 🧠 Intelligent Style Analysis: Uses LLMs to analyze and provide contextual fashion advice
  • 👁️ Image Recognition: Processes uploaded fashion items using computer vision
  • 🔄 Multi-Modal Interaction: Combines text and image inputs for comprehensive analysis
  • 🌤️ Context-Aware: Considers weather, occasion, and personal style preferences
  • ⚡ Flexible Architecture: Supports both online (Groq API) and offline modes
  • 💻 Modern UI: Built with Gradio for an intuitive user experience

🛠️ Technical Stack

Category Technologies
Backend Python 3.8+, FastAPI
AI/ML LlamaIndex, Groq API, PIL
Frontend Gradio, FastAPI
Data Custom Knowledge Base
DevOps Docker, Environment Management

🚀 Quick Start

  1. Clone and Setup

    git clone https://github.com/AnvitaPrasad/AgenticAIChatbot-AnvitaPrasad.git
    cd AgenticAIChatbot-AnvitaPrasad
    python -m venv venv
    source venv/bin/activate  # On Windows: venv\Scripts\activate
    pip install -r requirements.txt
  2. Configure Environment

    cp .env.example .env
    # Add your Groq API key to .env file
  3. Run the Application

    python simple_ui.py

💡 Usage Examples

from src.agents.fashion_advisor import AIris

# Initialize AIris with online mode
advisor = AIris(offline_mode=False)

# Get contextual outfit advice
advice = advisor.get_outfit_advice(
    "What should I wear to a summer wedding?",
    weather="hot",
    occasion="wedding",
    style="elegant"
)

# Get style inspiration with specific parameters
inspiration = advisor.get_inspiration(
    style="bohemian",
    season="summer",
    occasion="casual"
)

# Analyze an uploaded image
from PIL import Image
image = Image.open("outfit.jpg")
analysis = advisor.analyze_image(image)

🏗️ Project Structure

.
├── src/
│   ├── agents/              # AI agent implementations
│   │   ├── base_agent.py    # Base agent class
│   │   └── fashion_advisor.py # Main AIris implementation
│   ├── data/               # Knowledge base and data models
│   │   └── fashion_knowledge.py # Fashion rules
│   └── utils/              # Utility functions
│       ├── image_processor.py # Image processing
│       └── fashion_scraper.py # Data collection
├── app.py                  # FastAPI application
├── simple_ui.py           # Gradio web interface
├── requirements.txt       # Project dependencies
├── Dockerfile            # Container configuration
└── README.md

🔧 Implementation Details

  • 🎯 Agent Architecture: Modular agent system with base class for extensibility
  • 📚 Knowledge Management: Structured data models for fashion knowledge
  • 🛡️ Error Handling: Comprehensive error handling for API calls
  • ✅ Type Safety: Python type hints for better code reliability
  • ⚡ Async Support: Async/await patterns for efficient API interactions
  • 🎨 UI/UX: Responsive web interface with real-time updates

🌐 Live Demo

Try AIris now on Hugging Face Spaces!

📖 Documentation

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

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

👤 Author

Anvita Prasad


If you found this project interesting, please consider giving it a ⭐!

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors