README.md

---
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**
   ```bash
   docker build -t ai_service .
   ```

2. **Run the Container**
   ```bash
   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).

```bash
./start_and_setup.sh
```