grace-scripts

Grace AI helper scripts — token-efficient homelab automation.

These scripts replace inline shell construction in AI sessions, reducing token usage and making repeated tasks reproducible and auditable.

Scripts

Script	Purpose
convert-training-data.py	Convert raw session exports to unsloth/axolotl-ready JSONL
export-training-data.py	Export training data from OpenClaw sessions
export-transcripts.py	Export session transcripts incrementally
extract-sessions.py	Extract and parse session data
finetune-lora.py	Run LoRA fine-tuning on local Qwen3-8B
infra-audit.py	Audit homelab infra state and sync to MongoDB
infra-gitea-link.py	Link infra components to Gitea issues/repos
load-transcripts-to-db.py	Sync transcripts to PostgreSQL on DB VM
overnight-qwen3.py	Overnight batch inference job
overnight-research.sh	Overnight research and summarization
rag-ingest.py	Ingest documents into Qdrant for RAG
rag-query.py	Query Qdrant RAG index
install-unsloth.sh	Install unsloth fine-tuning framework

Credential Protocol

All scripts pull credentials from Infisical. Never hardcode secrets. IPs and service URLs reference TOOLS.md / BOOTSTRAP.md in the Grace workspace.

Token Reduction Strategy

Each script replaces multi-step inline shell that Grace would otherwise construct token-by-token in every session. One exec call to a script = ~10-50x fewer tokens than building the equivalent inline.

Issues & Improvements

Use Gitea issues on this repo to track bugs, improvements, and new script requests.