Skip to main content

0.0.4-beta.7 Configuration

Beta.7 keeps the same configuration model as beta.6 while moving the local model runtime to Hugging Face and strengthening sqlite-vec startup behavior for global installs.

Core config model

  • PROJECT_ROOTS -> highest priority runtime root override
  • LOCALNEST_CONFIG -> explicit config file path
  • working directory fallback -> used only when neither override is set

Beta.7 configuration notes

SettingExpected beta.7 behavior
MCP startup commandprefer localnest-mcp directly when installed globally
Startup timeoutkeep startup_timeout_sec at 30 or higher
Index backendsqlite-vec preferred, JSON fallback still supported
sqlite extensionauto-detected when possible, explicit path override supported
Embedding runtimeHugging Face provider/model is the intended runtime path
Memory database~/.localnest/data/localnest.memory.db when memory is enabled

Important environment variables

VariableDefaultDescription
LOCALNEST_CONFIG~/.localnest/config/localnest.config.jsonexplicit config file path
LOCALNEST_INDEX_BACKENDsqlite-vecrequested retrieval backend
LOCALNEST_DB_PATH~/.localnest/data/localnest.dbretrieval database path
LOCALNEST_INDEX_PATH~/.localnest/data/localnest.index.jsonJSON index path
LOCALNEST_SQLITE_VEC_EXTENSIONauto-detectedexplicit sqlite-vec native extension path
LOCALNEST_MEMORY_ENABLEDfalseenable memory subsystem
LOCALNEST_MEMORY_BACKENDautomemory backend selection
LOCALNEST_MEMORY_DB_PATH~/.localnest/data/localnest.memory.dbmemory database path

All core retrieval settings from surrounding beta lines still apply.