Local Second Mind (LSM)

Local-first RAG for personal knowledge management.

LSM ingests local documents, builds embeddings, retrieves relevant context, and produces cited answers with configurable LLM providers.

Version

0.6.0

Caveat Emptor

This project is maintained for personal use first.

• Pull requests are not accepted. See CONTRIBUTING.md for how to help.
• Bugs and feature requests are welcome as GitHub issues.
• Until v1.0.0, breaking changes can happen between releases, especially in configuration schema and interfaces.
• Pin versions and review docs/CHANGELOG.md before upgrading.

What Is New in 0.6.0

• Compact TUI layout with density modes (auto, compact, comfortable) for small terminals (80x24)
• Split modular CSS and refactored Settings screen with MVC architecture and ViewModel state
• Interactive agent approvals/replies with multi-agent runtime support and real-time log streaming
• TUI startup under 1 second with lazy background ML initialization
• Session-completed agent history, unified log formats, and refined agent screen UX
• Hardened TUI test infrastructure with fast/slow marker split and global state reset fixtures

Install

pip install -e .

Quick Start

1. Copy config:

cp example_config.json config.json

2. Add API keys to .env (see .env.example).

3. Build embeddings:

lsm ingest build

4. Start the TUI:

lsm

Minimal Config Example

{
  "global": {
    "global_folder": "C:/Users/You/Local Second Mind",
    "embed_model": "sentence-transformers/all-MiniLM-L6-v2",
    "device": "cpu",
    "batch_size": 32
  },
  "ingest": {
    "roots": ["C:/Users/You/Documents"]
  },
  "llms": {
    "providers": [{ "provider_name": "openai" }],
    "services": {
      "default": { "provider": "openai", "model": "gpt-5.2" }
    }
  }
}

CLI

• lsm - launch TUI
• lsm ingest build [--dry-run] [--force] [--skip-errors]
• lsm ingest tag [--max N]
• lsm ingest wipe --confirm

Global flags:

• --config path/to/config.json
• --verbose
• --log-level DEBUG|INFO|WARNING|ERROR|CRITICAL
• --log-file path/to/lsm.log

Documentation

• docs/README.md
• docs/user-guide/GETTING_STARTED.md
• docs/user-guide/CONFIGURATION.md
• docs/user-guide/QUERY_MODES.md
• docs/user-guide/NOTES.md
• docs/user-guide/REMOTE_SOURCES.md
• .agents/docs/INDEX.md
• docs/CHANGELOG.md

License

MIT (LICENSE)