Medical Fact Checker for macOS¶
Medical Fact Checker (MFC) for macOS provides a native desktop experience for evidence-based medical fact-checking, optimized for keyboard-driven workflows and Apple Silicon performance. Like its iOS counterpart, MFC focuses on answering medical questions and verifying health claims - for comprehensive systematic literature reviews, use the full BM Librarian desktop system.
App Store Status
The macOS version is currently awaiting App Store approval. Check back soon for the download link.
Requirements¶
- macOS: 14.0 (Sonoma) or later
- Processor: Apple Silicon (M1 or later)
- API key from a supported provider (see Obtaining API Keys)
- Internet connection for API calls and PubMed searches
Getting Started¶
Installation¶
- Open the Mac App Store
- Search for "Medical Fact Checker" or "MedicalFactChecker"
- Click Get to download and install
- Open the app from your Applications folder or Launchpad

Initial Setup¶
- Launch the app from Applications
- Select AI Provider: Choose your preferred provider
- Enter API Key: Paste your API key
- Configure settings: Adjust search and budget preferences

Interface Overview¶
The macOS app features a native interface designed for productivity:

Main Components¶
- Input Field: Enter medical claims to fact-check
- Results Panel: View evidence reports and citations
- Sidebar: Access search history and settings
- Toolbar: Quick actions and navigation
Using the App¶
Fact-Checking a Medical Claim¶
- Enter your claim in the input field at the top
-
Press
⌘+Nto focus the input field -
Press Return or click Check Fact to start analysis
-
Review results in the main panel:
- Verdict with confidence level
- Evidence summary
- Cited passages from literature
- Full reference list

Keyboard Shortcuts¶
| Shortcut | Action |
|---|---|
⌘+N |
New fact check |
⌘+, |
Open Settings |
⌘+E |
Export current report as PDF |
⌘+F |
Search within results |
⌘+1 |
Show/hide sidebar |
⌘+[ |
Previous result in history |
⌘+] |
Next result in history |
Esc |
Clear input / Cancel operation |
Features¶
Full-Text Article Viewing¶
Unlike mobile versions, the macOS app can display full article text:
- Click any citation in your results
- The article opens in the detail panel
- JATS XML Rendering: Full-text articles from open access sources display with proper formatting

Full Text Availability
Full text is available for open access articles from PubMed Central and Europe PMC. Subscription-only articles show abstracts with links to the source.
Hybrid Search¶
The macOS app searches multiple sources simultaneously:
- PubMed: NIH's database of biomedical literature
- Europe PMC: European life sciences literature database
This broader search often finds additional relevant articles.
PDF Export¶
Generate professional PDF reports:
- Complete a fact-check
- Press
⌘+Eor choose File → Export as PDF - Choose save location
- PDF includes full report, citations, and links
The macOS version uses native AppKit rendering for high-quality PDF output.
iCloud Sync¶
Your research syncs across all your Apple devices:
- Search history shared with iOS and iPadOS apps
- Settings sync automatically
- Seamless handoff between devices
Settings¶
Access settings via MedicalFactChecker → Settings (⌘+,).
General¶
- Appearance: Follow system, Light, or Dark mode
- Default Search Provider: Primary literature database
- Results per search: Number of articles to retrieve
AI Provider¶
- Provider Selection: Claude, OpenAI, DeepSeek, Mistral, Groq, or Ollama
- API Key Management: Securely store and update keys
- Model Selection: Choose specific model versions
- Pricing Info: View per-token costs for budgeting

Budget Controls¶
- Per-Analysis Limit: Maximum cost for single analysis
- Monthly Budget Cap: Total monthly spending limit
- Usage Dashboard: Current period spending
Advanced¶
- HyDE Enhancement: Toggle Hypothetical Document Embedding
- Ollama Configuration: Set custom server URL for local LLM
- Cache Settings: Manage local article cache
Using with Ollama (Local LLM)¶
The macOS app can use Ollama for completely offline, private fact-checking. See the Advanced: Ollama Setup guide for detailed instructions.
Quick Setup¶
- Install Ollama from ollama.com
- Pull a capable model:
ollama pull llama3.1:70b - In MedicalFactChecker settings, select Ollama as provider
- Set the URL to
http://localhost:11434 - Select your installed model
Model Recommendations
For medical fact-checking, larger models perform better. Consider:
llama3.1:70b- Best quality, requires 40GB+ RAMllama3.1:8b- Good balance of speed and qualitymixtral:8x7b- Strong reasoning, requires 32GB+ RAM
Tips for Power Users¶
Workflow Integration¶
- Services Menu: Right-click selected text in any app → Services → Check Medical Fact
- Shortcuts App: Create automations with the Shortcuts integration
- Quick Note: Copy results directly to Apple Notes
Multiple Fact Checks¶
- Open multiple windows with
⌘+Shift+N - Run parallel analyses
- Compare results side-by-side
Research Sessions¶
- Start with a broad claim
- Drill down into specific sub-questions
- Use history to track your research path
- Export a combined PDF of related fact-checks
Troubleshooting¶
"Unable to Connect to Ollama"¶
- Verify Ollama is running:
ollama listin Terminal - Check the URL in settings (default:
http://localhost:11434) - Ensure no firewall is blocking local connections
- Try restarting Ollama:
ollama serve
Slow Performance¶
- Check your internet connection
- Reduce the number of results per search
- For Ollama: ensure sufficient RAM for your model
- Close unnecessary applications
PDF Export Issues¶
- Ensure you have write permissions to the save location
- Try saving to Desktop first
- Check available disk space
- Restart the app if exports consistently fail
Sync Not Working¶
- Verify iCloud is enabled in System Settings
- Check that MedicalFactChecker has iCloud access
- Sign out and back into your Apple ID
- Check iCloud storage isn't full
Privacy & Security¶
- API Keys: Stored in macOS Keychain
- Local Processing: Ollama runs entirely on your Mac
- No Telemetry: No usage data collected
- Sandboxed: App runs in macOS security sandbox
Getting Help¶
- Menu Bar: Help → MedicalFactChecker Help
- GitHub: github.com/hherb/bmlibrarian_lite
- Email: Contact through App Store listing