index1 Doctor

Environment diagnostic skill for index1. Runs health checks and provides fix recommendations.

Usage

Type /doctor or ask the agent to diagnose index1.

What it checks

The skill runs three commands sequentially and analyzes results:

1. Environment Check

index1 doctor

Checks:

• Python version (>= 3.10 required)
• SQLite version (>= 3.43.0 for full features)
• sqlite-vec extension
• ONNX embedding (built-in, bge-small-en-v1.5)
• Ollama connectivity (optional, for multilingual/CJK)
• Embedding model availability
• CJK/Chinese support (jieba)

2. Index Status

index1 status

Shows:

• Document count and chunk count
• Collections list
• Last index time
• Database size

3. Ollama Models

ollama list

Shows installed models. Recommended embedding models:

• nomic-embed-text — Standard, 270MB
• bge-m3 — Best for CJK content, 1.2GB

Interpreting Results

Check	Pass	Fail Fix
Python	>= 3.10	Install Python 3.11+
SQLite	>= 3.43.0	Auto-degrades, no action needed
sqlite-vec	Loaded	pip install index1 (bundled)
Ollama	Connected	curl -fsSL https://ollama.com/install.sh | sh
Model	Available	ollama pull nomic-embed-text
CJK	jieba loaded	pip install index1[chinese]
Index	Has documents	index1 index ./src ./docs

When to use

• First-time setup verification
• After upgrading index1
• When search returns unexpected results
• When vector search stops working
• Before reporting issues