“BeeRad”
733d1c3407
Local-first knowledge management system with BYO API keys. Features: - 3-panel UI (Nodes | Focus | Helpers) - SQLite + sqlite-vec for vector search - Agent system (Easy/Hard mode orchestrators) - Content extraction (YouTube, PDF, web) - Integrate workflow for connection discovery - Dimension system with auto-assignment Tech stack: - Next.js 15 + TypeScript + Tailwind CSS - Anthropic (Claude) + OpenAI (GPT) via Vercel AI SDK Setup: npm install && npm rebuild better-sqlite3 scripts/dev/bootstrap-local.sh npm run dev MIT License
68 lines
1.8 KiB
Markdown
68 lines
1.8 KiB
Markdown
# RA-H Scripts
|
|
|
|
Utility scripts for managing the RA-H knowledge management system.
|
|
|
|
## Directory Structure
|
|
|
|
```
|
|
scripts/
|
|
├── database/ # Database management
|
|
│ ├── backup.sh # Create database backups
|
|
│ └── restore.sh # Restore from backups
|
|
├── helpers/ # Helper management (CRITICAL - used by API)
|
|
│ ├── duplicate-helper.js # Create new helpers
|
|
│ └── delete-helper.js # Remove helpers
|
|
└── migrations/ # Completed one-time migrations
|
|
└── cleanup-dimensions.sql
|
|
```
|
|
|
|
## Database Scripts
|
|
|
|
### Create a Backup
|
|
```bash
|
|
npm run backup
|
|
```
|
|
- Creates timestamped backup in `/backups/` folder
|
|
- Example: `rah_backup_20250902_102846.sql`
|
|
- Includes all nodes, chunks, edges, dimensions
|
|
|
|
### Restore from Backup
|
|
```bash
|
|
npm run restore backups/rah_backup_20250902_102846.sql
|
|
```
|
|
- ⚠️ **WARNING**: Replaces entire database
|
|
- Requires confirmation before proceeding
|
|
- Shows verification after restore
|
|
|
|
### List Backups
|
|
```bash
|
|
ls -lt backups/
|
|
```
|
|
|
|
## Helper Scripts
|
|
|
|
⚠️ **CRITICAL**: These scripts are used by the API at runtime. DO NOT modify or delete.
|
|
|
|
### Create New Helper
|
|
Called automatically by the API when creating helpers through the UI.
|
|
```bash
|
|
node scripts/helpers/duplicate-helper.js "HelperName"
|
|
```
|
|
|
|
### Delete Helper
|
|
Called automatically by the API when deleting helpers through the UI.
|
|
```bash
|
|
node scripts/helpers/delete-helper.js "helper-id"
|
|
```
|
|
|
|
## What Gets Backed Up
|
|
- All nodes (42,000+ knowledge items)
|
|
- Content chunks and embeddings
|
|
- Node connections/edges
|
|
- Dimensions and metadata
|
|
- Database schema and indexes
|
|
|
|
## Notes
|
|
- Backups typically ~250MB for 40k+ nodes
|
|
- Store backups safely - they contain your entire knowledge base
|
|
- Helper scripts are integrated with the application - modify with caution |