Ai Context Vault

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.