README.md

metadata

title: Kataria Optical API
emoji: 👓
colorFrom: blue
colorTo: indigo
sdk: docker
app_port: 7860
pinned: false

AI Frame Recommendation Service

This service analyzes facial features to recommend eyewear frames.

Tech Stack

• Python 3.10+
• FastAPI
• OpenCV (Contrib)
• Scikit-learn

Run with Docker (Recommended)

Docker handles all dependencies and ensures the AI models run correctly, avoiding Python version incompatibilities.

1. Build the Image

   docker build -t ai_service .
   

2. Run the Container

   docker run -p 8000:8000 ai_service
   

The API will be available at http://localhost:8000.

Local Setup (Dev Only)

If you cannot use Docker, you can run locally, but some AI features might be mocked if your Python version is incompatible (e.g., Python 3.14).

./start_and_setup.sh