data-pods

Create and manage modular portable database pods (SQLite + metadata + embeddings). Includes document ingestion with embeddings for semantic search. Full automation - just ask.

Overview

Create and manage portable, consent-scoped database pods. Handles document ingestion with embeddings and semantic search.

Architecture

text

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│  Ingestion  │ ──► │   DB Pods   │ ──► │  Generation │
│  (ingest)   │     │  (storage)  │     │   (query)   │
└─────────────┘     └─────────────┘     └─────────────┘

Triggers

• "create a pod" / "new pod"
• "list my pods" / "what pods do I have"
• "add to pod" / "add note" / "add content"
• "query pod" / "search pod"
• "ingest documents" / "add files"
• "semantic search" / "find相关内容"
• "export pod" / "pack pod"

Core Features

1. Create Pod

When user asks to create a pod:

1. Ask for pod name and type (scholar/health/shared/projects)
2. Run: python3 .../scripts/pod.py create <name> --type <type>
3. Confirm creation

2. Add Content (Manual)

When user asks to add content:

1. Ask for pod name, title, content, tags
2. Run: python3 .../scripts/pod.py add <pod> --title "<title>" --content "<content>" --tags "<tags>"
3. Confirm

3. Ingest Documents (Automated)

When user wants to ingest files:

1. Ask for pod name and folder path
2. Run: python3 .../scripts/ingest.py ingest <pod> <folder>
3. Supports: PDF, TXT, MD, DOCX, PNG, JPG
4. Auto-embeds text (if sentence-transformers installed)

4. Semantic Search

When user wants to search:

1. Ask for pod name and query
2. Run: python3 .../scripts/ingest.py search <pod> "<query>"
3. Returns ranked results with citations

5. Query (Basic)

When user asks to search notes:

1. Run: python3 .../scripts/pod.py query <pod> --text "<query>"

6. Export

When user asks to export:

1. Run: python3 .../scripts/podsync.py pack <pod>

Dependencies

bash

pip install PyPDF2 python-docx pillow pytesseract sentence-transformers

Storage Location

~/.openclaw/data-pods/

Key Commands

bash

# Create pod
python3 .../scripts/pod.py create research --type scholar

# Add note
python3 .../scripts/pod.py add research --title "..." --content "..." --tags "..."

# Ingest folder
python3 .../scripts/ingest.py ingest research ./documents/

# Semantic search
python3 .../scripts/ingest.py search research "transformers"

# List documents
python3 .../scripts/ingest.py list research

# Query notes
python3 .../scripts/pod.py query research --text "..."

Notes

• Ingestion auto-chunks large documents
• Embeddings enable semantic search
• File hash prevents duplicate ingestion
• All data stored locally in SQLite