cediackermann
171805bb62
- Add cleanup.sh for complete uninstallation - Interactive confirmations for each component - Safely removes Onyx, Ollama models, Docker, repository - Option to restore power settings - Warnings for shared components (Docker, Homebrew) - Fix Ollama installation to start service after install - Ensures ollama serve is running before model creation - Prevents "Unable to find application" error on clean Mac - Update README.md with cleanup script usage Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
158 lines
3.3 KiB
Markdown
158 lines
3.3 KiB
Markdown
# RIoT AI Setup Guide
|
|
|
|
> Step-by-step instructions for setting up a Mac Mini from scratch.
|
|
|
|
## Quick Start
|
|
|
|
**One-line installation** (recommended):
|
|
|
|
```bash
|
|
bash <(curl -fsSL https://raw.githubusercontent.com/cediackermann/riotsecure/main/setup.sh)
|
|
```
|
|
|
|
Or clone and run locally:
|
|
|
|
```bash
|
|
git clone https://github.com/cediackermann/riotsecure.git
|
|
cd riotsecure
|
|
./setup.sh
|
|
```
|
|
|
|
The script automates most steps and pauses for manual configuration when needed (Docker settings, web interface setup, etc.).
|
|
|
|
**After installation**, verify everything is working:
|
|
|
|
```bash
|
|
cd ~/riotsecure
|
|
./check-status.sh
|
|
```
|
|
|
|
**To uninstall**, run the cleanup script:
|
|
|
|
```bash
|
|
cd ~/riotsecure
|
|
./cleanup.sh
|
|
```
|
|
|
|
For detailed manual instructions, continue reading below.
|
|
|
|
---
|
|
|
|
## 1. Homebrew
|
|
|
|
```bash
|
|
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
|
|
```
|
|
|
|
Add Homebrew to your shell profile:
|
|
|
|
```bash
|
|
echo >> /Users/riot/.zprofile
|
|
echo 'eval "$(/opt/homebrew/bin/brew shellenv zsh)"' >> /Users/riot/.zprofile
|
|
eval "$(/opt/homebrew/bin/brew shellenv zsh)"
|
|
```
|
|
|
|
---
|
|
|
|
## 2. Ollama
|
|
|
|
```bash
|
|
curl -fsSL https://ollama.com/install.sh | sh
|
|
```
|
|
|
|
---
|
|
|
|
## 3. Docker Desktop
|
|
|
|
```bash
|
|
brew install --cask docker-desktop
|
|
open -a Docker
|
|
```
|
|
|
|
Click through the installer and install any prompted software updates.
|
|
|
|
### Adjust Resources
|
|
|
|
Go to **Docker → Settings → Resources** and set:
|
|
|
|
| Setting | Value |
|
|
| ---------------- | ----- |
|
|
| CPU limit | MAX |
|
|
| Memory limit | 20 GB |
|
|
| Disk usage limit | MAX |
|
|
|
|
Hit **Apply & Restart**.
|
|
|
|
---
|
|
|
|
## 4. Onyx
|
|
|
|
```bash
|
|
curl -fsSL https://onyx.app/install_onyx.sh | bash
|
|
```
|
|
|
|
When prompted:
|
|
|
|
1. Press **Enter** to acknowledge
|
|
2. Choose **2** for Standard
|
|
3. Press **Enter** for Edge
|
|
|
|
Onyx creates `~/riotsecure/onyx_data/`, which contains the Docker Compose file (useful for manually stopping or modifying images). There is also a `.env` file — leave it untouched.
|
|
|
|
### Prevent Sleep
|
|
|
|
```bash
|
|
sudo pmset -a sleep 0 disksleep 0
|
|
```
|
|
|
|
---
|
|
|
|
## 5. Ollama Models
|
|
|
|
1. Clone the repo:
|
|
|
|
```bash
|
|
cd ~
|
|
git clone https://github.com/cediackermann/riotsecure.git
|
|
cd ~/riotsecure
|
|
```
|
|
|
|
2. Create models from modelfiles:
|
|
|
|
```bash
|
|
./updateModels.sh modelfiles
|
|
```
|
|
|
|
The required base model is pulled automatically — just wait for it to finish.
|
|
|
|
3. Open the web interface on port **3000** and create an admin account.
|
|
4. Go to **Admin Panel → Language Models**:
|
|
- Select **Ollama** as provider and give it a name
|
|
- Set the API base URL to `http://host.docker.internal:11434`
|
|
- Refresh the model list, select at least the three RIoT models, and click **Connect**
|
|
5. Go to **Admin Panel → Chat Preferences → System Prompt → Modify Prompt**, delete the entire prompt, and save.
|
|
|
|
---
|
|
|
|
## 6. RAG Content Upload
|
|
|
|
### Option A — Upload as File
|
|
|
|
1. If needed, edit the URLs in `riot-sources.txt`.
|
|
|
|
2. Fetch content:
|
|
|
|
```bash
|
|
cd ~/riotsecure
|
|
./fetchContent.sh riot-sources.txt
|
|
```
|
|
|
|
3. In the web interface, go to **Admin Panel → Add Connector → File**.
|
|
4. Give the connector a name and upload the files from `~/riotsecure/content`.
|
|
5. Wait ~30 seconds for indexing to complete.
|
|
|
|
### Option B — Upload as URL
|
|
|
|
1. In the web interface, go to **Admin Panel → Add Connector → Web**.
|
|
2. Add each URL as a separate connector, using scrape method **Single**.
|
|
3. Wait ~30 seconds for indexing to complete.
|