Add configurable LLM provider adapters for email classification

README.md

@@ -0,0 +1,88 @@
+# email-classifier
+
+FastAPI service that classifies email using a configurable LLM backend.
+
+## What changed
+
+The classifier no longer hardcodes a single Ollama + OpenAI-compatible endpoint.
+It now supports:
+- OpenAI-compatible APIs
+- Anthropic-compatible APIs
+- per-request overrides for provider, model, endpoint, and temperature
+- global defaults through environment variables
+
+This makes it suitable for local Ollama, hosted OpenAI-compatible services, and MiniMax's recommended Anthropic-compatible API.
+
+## Environment configuration
+
+Defaults are loaded from environment variables:
+
+```bash
+export LLM_PROVIDER=openai
+export LLM_BASE_URL=http://ollama.internal.henryhosted.com:9292/v1
+export LLM_API_KEY=none
+export LLM_MODEL=qwen2.5-7b-instruct.q4_k_m
+export LLM_TEMPERATURE=0.1
+export LLM_TIMEOUT_SECONDS=60
+export LLM_MAX_RETRIES=3
+```
+
+### MiniMax example
+
+MiniMax recommends Anthropic-compatible integration.
+
+```bash
+export LLM_PROVIDER=anthropic
+export LLM_BASE_URL=https://api.minimax.io/v1
+export LLM_API_KEY=your_minimax_key
+export LLM_MODEL=MiniMax-M2.7
+```
+
+## API
+
+### POST /classify
+
+Request body:
+
+```json
+{
+  "email_data": {
+    "subject": "Can you review this by Friday?",
+    "body": "Hi Daniel, please review the attached budget proposal."
+  },
+  "provider": "anthropic",
+  "base_url": "https://api.minimax.io/v1",
+  "model": "MiniMax-M2.7",
+  "temperature": 0.1
+}
+```
+
+All override fields are optional. If omitted, the service uses the global env config.
+
+Response shape:
+
+```json
+{
+  "needs_action": true,
+  "category": "question",
+  "priority": "high",
+  "task_description": "Review the budget proposal and respond by Friday",
+  "reasoning": "Direct request with a deadline requires follow-up",
+  "confidence": 0.91
+}
+```
+
+## Architecture
+
+- `app/config.py`: global and per-request LLM settings
+- `app/llm_adapters.py`: provider adapters
+- `app/classifier.py`: classification orchestration, retries, normalization
+- `app/prompts.py`: system prompt
+- `app/routers/classify_email.py`: thin API route
+
+## Notes
+
+- OpenAI-compatible providers use the OpenAI SDK.
+- Anthropic-compatible providers use the Anthropic SDK.
+- Per-request `api_key` is supported, but excluded from response serialization.
+- The service normalizes malformed model output and falls back safely after retry exhaustion.