AI Context Vault

About

DETAILED SETUP INSTRUCTIONS FOR REVIEWERS

This extension requires Ollama (free, open-source AI platform) to function. 
This is INTENTIONAL - for 100% local, private AI processing.

COMPLETE STEP-BY-STEP GUIDE:
Please see REVIEWER_INSTRUCTIONS.md in the package for complete testing guide.

QUICK SUMMARY (10 minutes total):

1. INSTALL OLLAMA (2 min)
   - Windows: https://ollama.ai/download/OllamaSetup.exe
   - macOS: https://ollama.ai/download/Ollama-darwin.zip
   - Linux: curl -fsSL https://ollama.ai/install.sh | sh

2. CONFIGURE CORS (30 seconds) - CRITICAL!
   - Windows: setx OLLAMA_ORIGINS "*"
   - Mac/Linux: export OLLAMA_ORIGINS="*"
   - Why: Chrome blocks localhost by default (CORS policy)
   - Restart terminal after setting this

3. DOWNLOAD MODELS (5 min)
   - ollama pull llama3
   - ollama pull nomic-embed-text

4. START OLLAMA
   - Run: ollama serve
   - Keep terminal open
   - Should show: "Listening on http://localhost:11434"

5. TEST EXTENSION
   - Load extension → Onboarding opens automatically
   - Should show "✅ Ollama Connected"
   - Go to ChatGPT, have conversation (6+ messages)
   - Extension auto-saves
   - Click extension → Should show memories count
   - Test search & restore → Works correctly

EXPECTED RESULT:
- Extension shows "● Ollama Connected" (green)
- Auto-saves conversations
- Context restore works
- All features functional

TROUBLESHOOTING:
If you see "ERR_CONNECTION_REFUSED":
- Verify CORS is set: echo $OLLAMA_ORIGINS (should show *)
- Restart terminal after setting CORS
- Run ollama serve again
- Reload extension

WHY LOCALHOST IS REQUIRED:
This extension provides LOCAL AI processing for privacy:
- No cloud APIs (free forever)
- No data transmission (complete privacy)
- No API keys (user convenience)

Similar to Docker extensions requiring Docker, or Git extensions 
requiring Git - this extension requires Ollama for local AI.

VERIFICATION:
- See REVIEWER_INSTRUCTIONS.md for complete guide
- See QUICK_START_REVIEW.txt for condensed version
- See CORS_FIX_FOR_REVIEWERS.md for CORS troubleshooting
- See architecture-diagram.svg for technical overview

We're available for live demo or screen share if needed.

The extension is fully functional when Ollama is properly 
configured as documented.