Skip to content

P.O.W.E.R. Framework 3.6.2

P.O.W.E.R. is a local-first, Git-native toolkit for structured knowledge bases. It combines P.A.R.A., validated OKF frontmatter, hierarchical indexes, full-text and semantic retrieval, and an MCP interface for AI agents.

Start here

These guides define the immutable v3.6.2 release artifact contract, use an isolated virtual environment, and include acceptance checks. Publication is complete only when the signed tag, wheel, source archive, SBOM, and release receipts can be read back from GitHub. The migration guides keep the source immutable, reconcile every file by manifest and hash, and make cutover reversible.

Executable contract

  • Python 3.11 or newer.
  • 25 top-level CLI commands; see the CLI reference.
  • 20 MCP tools; see the MCP server reference.
  • auto is the default search profile: verified dense when ready, otherwise labelled FTS; semantic and reranked are explicit opt-ins.
  • The generated root index and MCP sub-index operations cover the canonical P.A.R.A. directories. Arbitrary source layouts must be mapped during migration.
  • The canonical dense backend is BAAI/bge-m3; model-backed checks download large artifacts. FTS5 works without model downloads.

Minimal quick start

python -m venv .venv
. .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install \
  "https://github.com/weby-homelab/power-framework/releases/download/v3.6.2/power_framework-3.6.2-py3-none-any.whl"

power init ./my-vault
power index ./my-vault --strict
power lint ./my-vault
power sync ./my-vault --fts-only

On Windows, use the dedicated PowerShell guide rather than translating these POSIX commands.

Claims and evidence

Historical vault measurements and synthetic benchmarks are useful diagnostics, not universal performance guarantees. The POWER 3.1 trust-release baseline defines the evidence boundary. The hierarchical-index reports are explicitly preserved as v1.6 historical snapshots.

More documentation

GPLv3 — Built in Ukraine ⚡