Wyrm

Install

npm install -g wyrm-mcp

Start

Run the MCP server with wyrm-mcp and wire clients with wyrm-setup.

Storage

Wyrm stores data in a single SQLite database at ~/.wyrm/wyrm.db by default. Use --db to override the path.

Capabilities

• Persistent session memory for truths, lessons, quests, and artifacts
• Hybrid recall with FTS5 plus local semantic vectors
• Failure firewall / negative learning via wyrm_failure_record, wyrm_failure_check, and wyrm_failure_resolve
• Optional NVIDIA NIM embeddings and reranking for higher-accuracy retrieval

Configuration

Runtime environment variables documented upstream:

• WYRM_VECTOR_PROVIDER to select the embedding provider, including nim
• WYRM_RERANK_PROVIDER to select the reranker, including nim
• WYRM_EMBED_MODEL to override the embedding model
• WYRM_RERANK_MODEL to override the rerank model
• NIM_BASE_URL to override the NVIDIA NIM endpoint
• NIM_API_KEY for hosted NIM access
• WYRM_SKIP_TERMUX_FIX to skip the Termux install patch

Requirements and limitations

• Node.js 22 or newer
• Optional local Ollama with nomic-embed-text for local semantic recall
• Optional NVIDIA API key and NIM access if hosted retrieval is enabled
• Native build tools may be required on platforms that fall back to source builds of better-sqlite3
• Hosted NIM sends the selected text to the configured endpoint; local mode keeps data on-device