Installation Wizard #339
Description
Description
Streamlined, plug-and-play installation process for InterBrain with all external dependencies.
External Dependencies to Abstract
- Obsidian plugin installation
- Radicle DID setup
- Ollama (semantic search)
- Python-based real-time transcription
- Vault initialization
Requirements
- Maximum simplicity for non-technical users
- Security considerations (avoid blind script execution)
- LLM-assisted security validation approach (user + AI = security expert team)
Installation Flow Goals
- Unified setup wizard
- Clear progress indication
- Graceful error handling
- Minimal manual terminal commands
Novel Approach: LLM-Assisted Security
Philosophy: Instead of locking everything down to be "idiot-proof", leverage AI to empower users.
Key Insight: Average users can now have security experts (capable LLMs) at their side, enabling them to navigate more complex installation methods safely.
Avenues to Explore:
- Provide install scripts that would traditionally be "too risky"
- User + LLM scan scripts together before execution
- LLM flags suspicious code patterns, injections, security issues
- Guide users through verification process
- Enable "Wild West" distribution with AI safety net
- Transform average users into security-aware power users
Benefits:
- Simpler distribution (scripts vs complex locked-down installers)
- Educational (users learn what scripts do)
- Flexible (easy to update and customize)
- Secure (AI validation catches issues)
Note: This doesn't need to be perfect for soft beta, but defines the direction for iteration.
Parent Issue
Part of Epic #258 - Coherence Beacon System (Soft Beta milestone)
Definition of Done
- All external dependencies identified and cataloged
- Installation flow designed and documented
- Wizard implementation complete
- Security validation approach defined (including LLM-assisted model)
- Tested on fresh machine with no dependencies
- Documentation for users and developers