feat: ✨ Allow users to choose AI model

[marcvergees]

Walkthrough: Allow users to choose AI model when filling forms

We have implemented the feature allowing users to select their preferred AI model when filling out forms, automatically pulling/installing models from Ollama if they are not already cached locally.

Changes Made

backend

[MODIFY] forms.py (Schema)

• Added ModelPullRequest schema.

[MODIFY] forms.py (Routes)

• Added POST /api/v1/forms/pull endpoint which pulls the model from Ollama with a 10-minute timeout.

[MODIFY] test_api.py

• Added unit tests for successful and failed model pull endpoints.

frontend

[MODIFY] storage.ts

• Implemented loadSelectedModel and saveSelectedModel to persist the selected model in localStorage.

[MODIFY] api.ts

• Exposed the pullModel api function to make the pull request to the backend.

[MODIFY] FillForm.tsx

• Rendered recommended models (qwen2.5:1.5b, qwen2.5:3b, qwen2.5:7b, llama3.2:3b, mistral:7b) along with any other installed models dynamically in the dropdown.
• Configured selection persistence.
• Automatically triggers a model download/installation when a model not currently installed on the host is selected.
• Displays loading status and disables form filling/dropdown changes during download.

documentation

[MODIFY] [1. SETUP.md](file:///Users/marcvergessantiago/Desktop/FireForm/docs/1. SETUP.md)

• Added AI Model Selection documentation explaining supported models, how automatic download works, and how they are cached.

Verification

Automated Tests

• Backend make test executed successfully with 147 passed tests.
• Frontend npm run typecheck executed successfully without compilation issues.