v0.2.2

Persome Runtime v0.2.2

This is the first public alpha of the standalone Persome Runtime: a local-first
macOS daemon that collects focused cross-app context, builds an inspectable
Point/Line/Face/Volume/Root personal model, and exposes it to Chat and MCP
clients.

Highlights

• macOS Accessibility capture with optional, bundled on-device PP-OCRv6;
• five-minute active-session modeling without stopping the daemon;
• durable Markdown plus SQLite/FTS5, receipts, bitemporal history, correction,
  redacted export, and complete deletion;
• streamable HTTP and stdio MCP, terminal Chat, and a local 3D model viewer;
• synthetic sample model and real MCP transport verification with no key or
  personal data;
• source distribution, wheel, and SHA256SUMS release artifacts.

Install

git clone https://github.com/Persome-ai/persome-core.git
cd persome-core
bash install.sh
persome start
open http://127.0.0.1:8742/model

The GitHub Release wheel is a verified install artifact, but install.sh is
the supported first-run path because it also compiles the macOS AX helpers,
creates the private environment file, and configures local clients.

Verification

The release workflow runs the offline test suite on mocked LLMs, ruff, shell
syntax, secret/PII/language/documentation scans, synthetic MCP transport smoke,
wheel installation outside the checkout, and bundled-resource checks. Verify
downloaded artifacts with either platform's built-in checksum tool:

# macOS
shasum -a 256 --check SHA256SUMS

# Linux with GNU coreutils
sha256sum --check SHA256SUMS

Known limitations

• Live capture supports macOS 13 and newer. Linux is for offline development;
  Windows is unsupported.
• Intel Macs support AX capture, Runtime, Chat, and MCP, but not bundled OCR
  because the required Paddle runtime has no compatible Intel wheel.
• Accessibility permission is required for useful live capture. Screen
  Recording is optional and used only for local OCR fallback or encrypted
  screenshot retention.
• Semantic modeling requires a user-supplied Anthropic API key or compatible
  gateway. Capture and BM25 retrieval continue without one.
• The loopback API has no second bearer-token layer. Connect only trusted local
  clients and do not expose the port through a tunnel.
• This alpha has no hosted account, sync service, telemetry, browser Chat UI,
  remote deployment contract, or PyPI publication.
• Synthetic Runtime gates are not a real-person memory-quality or next-action
  benchmark. Research evaluation belongs in a separately licensed benchmark
  repository.