secondbrain

Installation

Clone the repository and install dependencies:

git clone <repo-url>
cd secondbrain
uv sync

Usage

Via the CLI entrypoint:

uv run secondbrain

With dev environment variables:

uv run --env-file .env secondbrain

Via Python module:

uv run python -m secondbrain

Environment Variables

Copy .env.example to .env for development defaults:

cp .env.example .env

Then run with uv run --env-file .env secondbrain to load dev settings. Note: uv does not auto-load .env — you must pass --env-file .env explicitly.

Variable	Default	Description
LOG_LEVEL	INFO	Console log level. Set to DEBUG in .env for verbose output.
LOG_FILE	app.log	Path to the log file.

Log output uses a compact format with 4-letter level abbreviations (TRAC, DEBG, INFO, SUCC, WARN, ERRR, CRIT) and pipe separators:

2026-04-11 15:23:44 | INFO | secondbrain.app:main:29 | Hello from secondbrain!

Testing

Run tests:

uv run pytest

Run tests with coverage:

uv run pytest --cov

Documentation

Preview docs locally:

uv run python scripts/serve_docs.py

Build static docs:

uv run mkdocs build