requirements.txt

# ═══════════════════════════════════════════════════════════════
#  S T A R R Y N O T E  ·  Requirements
#  Python 3.11+  ·  Apple Silicon (M1/M2/M3/M4)
# ═══════════════════════════════════════════════════════════════

# --- Core AI & ML (Apple Silicon Optimized) ---
mlx-lm                  # Apple's MLX framework for running LLMs on Metal GPU
huggingface_hub         # Download Gemma 3 weights from Hugging Face

# --- Terminal UI ---
rich                    # Cyberpunk TUI: neon panels, tables, progress bars

# --- File Processing ---
python-magic            # MIME type detection via binary headers (libmagic)
pymupdf                 # High-performance PDF text & image extraction (fitz)
pillow                  # Image processing (PIL) for multimodal analysis

# --- Development & Testing ---
pytest                  # Unit testing framework
black                   # Code formatter (PEP 8 compliance)