Added:
- One-line installer instructions with prerequisites clearly listed
- Step-by-step installation guide for macOS and Linux
- Detailed Scripts Guide documenting all 8 shell scripts
- Project initialization workflow (3 steps to make Claude an expert)
- Clear explanation of setup.sh vs setup_native.sh differences
- Honest documentation of what auto-installs vs what needs pre-installation
Changes:
- Reorganized Quick Start section with prerequisites at top
- Added one-line curl installer option prominently
- Expanded Scripts Guide with individual sections for each script
- Added "Initialize Your Project" section with project creation and ID steps
- Clarified that Python 3.11+ and Git must be pre-installed
- Documented that Ollama and Redis auto-install if missing
This makes Claude OS onboarding much clearer and more professional.
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
Features:
- Fixed Ollama configuration for native (localhost) instead of Docker
- Increased LLM timeout from 30s to 120s for quality answers
- Implemented KB slug system for clean MCP endpoint URLs
- Added multiple knowledge base support with type metadata
- Integrated MCP server with FastAPI (port 8051)
- React frontend with KB management UI
- PostgreSQL + pgvector for vector embeddings
Performance:
- 33-56% faster than Docker setup with native Ollama
- Direct Metal GPU acceleration on Apple Silicon
- Optimized RAG engine with caching
- ~40s response time for comprehensive answers
Documentation:
- Complete native setup guide (README_NATIVE_SETUP.md)
- Performance benchmarking and comparison
- MCP endpoint documentation
- Slug implementation details
- Decision rationale for native vs Docker
Cleanup:
- Removed old Streamlit setup files
- Consolidated setup scripts to single setup_native.sh
- Consolidated service management scripts
- Removed test artifacts and old analysis docs
- Ready for sharing with team
🚀 Production-ready for local team deployment
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
