KYM

KYM

What it does: A local-first, peer-to-peer, zero-based budget on the Logos stack

Stage: Almost done

Licence: MIT or Apache-2.0

Build · Use · Code · User reviews

Verified on 4 November 2026 against README and commit of 10 October 2026.

KYM (Know Your Money) is a household envelope budget that syncs between its users' own devices over Logos Messaging (Logos Delivery, also called Waku), with a Basecamp module for the desktop and an Android app. It is published by the GitHub user vpavlin.

What it does

• Keeps a zero-based envelope budget with no server and no cloud custody of the finances. The README calls it a YNAB alternative.
• Syncs a household's budget directly between its devices over Logos Delivery, end-to-end encrypted.
• Holds several budgets at once. Each budget is its own household, with its own secret, topic and event log, and is shared by showing its QR code or pairing code.
• Records money as an append-only ledger. An edit is a new event and a delete is a tombstone, so two people editing offline end up with the same budget after sync.
• Runs a desktop view in Basecamp (kym) over a core module (kym_core). The same core can run headless under logoscore as an always-on hub.
• Has an Android companion app for logging an expense quickly, with on-device receipt OCR.
• Includes a command-line budget with accounts, categories, targets, bank import, reconciliation and reports.

Stage: Almost done. The README says the engine, contract, crypto, merge and both module builds "are green and cross-checked", and that "The mobile Delivery transport is still being stabilised on real hardware." The README does not say whether it is an official Logos project.

Use it

1. In Basecamp, open Settings, then Package Repositories, and add https://apps.vpavlin.xyz/logos-repo.json.
2. Install the two packages kym_core (the core module) and kym (the view).
3. For Android, install the APK from the F-Droid repository at apps.vpavlin.xyz. It is built for arm64 phones.
4. To try it without Basecamp, run npm install, npm test and npm run demo in the repository, then drive a budget with node cli/kym.mjs.

The README does not name a Basecamp version.

Build it

• npm install sets up the packages. npm test runs the engine and sync tests and npm run demo shows two partners editing one budget offline and then syncing.
• The Android APK is built and signed locally with scripts/build-apk.sh.
• Releases are cut by pushing a module-v* tag. CI then builds the portable .lgx and refreshes repo/index.json.

Releases

The latest tag is v0.8.0, dated 4 August 2026. module/metadata.json gives the kym view version 0.7.0, and kym_core/metadata.json gives kym_core version 0.8.1.

See also

• Basecamp
• Tools
• Logos Messaging
• Perun

Sources

• kym README, GitHub, last commit 10 October 2026
• module/metadata.json and kym_core/metadata.json, GitHub
• kym tags, GitHub

Page status: Stub. Stub · Outline · Usable · Guide · Star. Anyone can improve this page and change its status.