Describe Lumi's optional online AI in the privacy policy and README

The policy now says what Lumi sends online and where, how feedback and
Telegram messages are kept, and how to stay offline or withdraw; the
README points to it and adds contributing and security reporting.
This commit is contained in:
waozi committed 2026-10-19 18:40:31 -03:00
1 parent b17231c892
commit 71dcef992b
5 files changed
+90 -21

No files matched your search

+31
View File
@@ -0,0 +1,31 @@
# Contributing to Inner Breeze
Report a bug through Lumi's feedback card in the app or
[GitHub Issues](https://github.com/waozixyz/inbe/issues). Include the app version,
platform, steps to reproduce, what you expected, and what happened. Keep account
keys, private conversations and personal practice data out of public reports.
For a security issue, use [Security](SECURITY.md).
## Development
Build with `make native cells`. Dependencies and the Ziran toolchain are pinned
in `ziran.lock`; see [README](README.md#build) for other platforms. Read
[AGENTS.md](AGENTS.md) for repository conventions and
[app packages](docs/cells.md) for module ownership.
Keep a change focused. Put app UI in its owning package, reusable Kryon changes
in Kryon, and compiler changes in Ziran. Preserve existing data and upgrade
paths. Translate changed app strings in every supported locale.
Run the tests that exercise the changed behavior and `git diff --check`.
For UI changes, run `make clean-text-api-check button-api-check` and the relevant
private-display UI tests. `make test` and `make visual-test` are the CI gates.
Android adapter tests need Java 17 and Android SDK platform 36; set
`ANDROID_SDK_ROOT` to your SDK directory.
Visual tests create disposable profiles and private displays; they must never
use your desktop or personal profile. See [verification](docs/cells.md#verification)
for the additional exact-source phone and release checks.
In a pull request, explain the user-visible change and list the checks you ran,
including any platform you could not verify. A build or a commit does not
publish a release.
+10 -1
View File
@@ -24,7 +24,8 @@ practice from another device connected to the same account.
## Features
- Lumi, a local firefly companion with private chat, habit completion, practice starts, and optional todo tools
- Lumi, a firefly companion with offline commands and optional online AI chat,
habit completion, practice starts, and optional todo tools
- Guided practice sessions with visual and audio cues
- Mind, Yoga, and Fitness organization for different practice routines
- Customizable breathing sessions, meditation timers, and habit counters
@@ -33,6 +34,14 @@ practice from another device connected to the same account.
- Theme customization with light and dark variants
- Repeat the last completed practice using its current settings
Lumi starts offline. Online AI requires agreement to the data sharing shown in
the app; you can use Inner Breeze's service or configure your own provider.
See the [privacy policy](site/static/privacy.html) and
[Lumi's connection modes](docs/cells.md#lumi).
For changes and bug reports, see [Contributing](CONTRIBUTING.md).
Report security issues through [Security](SECURITY.md).
## Build
The build checks Inbe's laws with the Ziran compiler (`ziran check`); no
+10
View File
@@ -0,0 +1,10 @@
# Reporting a security issue
Email [[email protected]](mailto:[email protected]) privately with the affected
Inner Breeze version, platform, reproduction steps and expected impact.
Use a disposable account or sample data when possible. Do not include private
keys, API keys or other people's data.
Use [GitHub Issues](https://github.com/waozixyz/inbe/issues) for ordinary bugs.
Please keep unpatched security details out of public reports while the issue
is investigated.
+21 -14
View File
@@ -15,8 +15,9 @@ or `assets/leaderboard/`.
The cell picker, Lists and Diary editor/calendar compose the
standard Kryon widgets inside their ZIBs. Raylib, Android and canvas bind the
same typed render effects to their normal widgets. File dialogs, persistence,
account sync and native input stay in the wrapper. Habits draws a counting
habit's count dialog in its package (`apps/habits/habits_view.zi`); its
account sync and native input stay in the wrapper. Habits draws its count
dialog and editor save/discard/delete confirmations in its package
(`apps/habits/habits_view.zi` and `editor_dialogs.zi`); its
table, editor, entries, history and statistics, and Practices' screens,
still use compiled screen compositions; migrating those screens is required
before every visual change can ship without rebuilding the wrapper.
@@ -51,12 +52,12 @@ on close and restart, on a private display with disposable profiles.
## Lumi
Lumi is the default home for new profiles and for the first launch after her
introduction. Existing app choices and todo data are retained. Settings lists
New profiles choose a language and optional audio, then open Apps with Lumi,
Habits and Practice pinned. Existing app choices and todo data are retained. Settings lists
Lumi in the same compact list as every other cell. Removing her shortcut
keeps her package, conversation and app abilities; she cannot be uninstalled.
Her firefly image belongs to `assets/lumi/mascot.png` in her package and appears
beside her replies. The conversation has no title bar; navigation uses a
beside her replies. The conversation has compact connection controls; navigation uses a
monochrome outlined firefly, matching the other navigation glyphs. The sidebar
uses `assets/lumi/sidebar.shape` with the standard button size and foreground;
navigation bars use the matching transparent `assets/lumi/sidebar.png`.
@@ -64,9 +65,14 @@ The chat avatar is mirrored toward the conversation. Enter sends a message;
Shift+Enter inserts a new line and the composer grows with the draft.
`apps/lumi/lumi_view.zi` composes the chat and command suggestions with hosted
Kryon widgets. `apps/lumi/engine.zi` is the first small offline interpreter;
its typed `LumiAction` output is the boundary for a future on-device model.
There is no cloud inference, model download or trained model in this version.
Kryon widgets. `apps/lumi/engine.zi` interprets supported commands offline;
its typed `LumiAction` output is validated by the host before an action runs.
Offline commands need no AI model or model download. Lumi starts offline.
After agreement to the in-app terms, online AI can answer other requests
through Inner Breeze's service or the person's own compatible provider.
`src/cells/lumi_connection.zi` owns connection choice and agreement;
`src/cells/lumi_online.zi` owns requests. Switching offline stops AI requests.
The agreement explains the conversation and app context sent to each route.
Translated commands and the stable `/todo TITLE`, `/done TITLE`, `/reopen TITLE`,
`/habit NAME`, `/lists`, `/habits`, `/practices` and `/diary` forms work offline.
`start whm` starts the Wim Hof Method immediately; meditation, Sun Salutation
@@ -95,9 +101,10 @@ The wrapper validates IDs and live state again before using the existing
user-scoped storage, sync outbox and practice registry. A practice starts after
the chat cell finishes its call, within the same application frame.
The conversation keeps the latest 32 exchanges in the active user's local
settings. It survives restart, resets on account changes, and is not part of
account preference sync. The wrapper provides input, persistence and bounded
The conversation is saved as account-scoped records, with older messages loaded
on demand. It survives restart, follows the active account, and can sync as
encrypted records when an account is connected. Online AI agreement is separate
from account sync. The wrapper provides input, persistence and bounded
app effects; no database pointers or arbitrary code cross the cell boundary.
Lumi can open Settings or Appearance, change the app theme with `/theme forest`
@@ -213,9 +220,9 @@ once in APK assets and opens its bytes through the NDK asset manager. Each
CPU library contains only the native host and small bootstrap assets, so a
universal APK shares the artwork across all four architectures. Direct Gradle
builds run `make cells` and stage the current package before merging assets.
Lists and Diary are
absent from that root and the native embedded payload. Recommended apps work
offline. Downloaded packages are stored in the private `packages/` directory
All six app packages are included in that root and can be opened offline;
Lumi, Habits and Practice are pinned by default. Downloaded updates and other
apps are stored in the private `packages/` directory
beside `inbe.db`. The host checks signed release identity, API compatibility,
hash, size, allowed capabilities and the typed identity handshake before
publishing an immutable payload and atomically replacing its current pointer.
+18 -6
View File
@@ -33,7 +33,7 @@
<p class="eyebrow"><span></span> privacy · plainly explained</p>
<h1 id="policy-title">Your practice<br><em>belongs to you.</em></h1>
<p class="policy-lede">Inner Breeze is local-first. Core breathing, meditation, habit, and break-reminder features work without an account, advertising, or analytics.</p>
<p class="policy-date">Effective September 4, 2026</p>
<p class="policy-date">Effective October 18, 2026</p>
</div>
<aside class="policy-promise" aria-label="Privacy at a glance">
<p class="policy-promise-label">At a glance</p>
@@ -64,7 +64,7 @@
<section id="summary" class="policy-section policy-section-featured">
<p class="policy-kicker">01 · The short version</p>
<h2>Private by default.</h2>
<p>Inner Breeze stores your practice data on your device. It does not include advertising SDKs or analytics services, and we do not sell personal data. Data leaves your device only when you access the web version or ask the app to use an online or operating-system feature, such as sync, friends, push notifications, a download, a purchase, or Health Connect.</p>
<p>Inner Breeze stores your practice data on your device. It does not include advertising SDKs or analytics services, and we do not sell personal data. Data leaves your device only when you access the web version or ask the app to use an online or operating-system feature, such as sync, Lumi's online AI, feedback, friends, push notifications, a download, a purchase, or Health Connect.</p>
</section>
<section id="local-data" class="policy-section">
@@ -76,6 +76,7 @@
<li>Habit names, schedules, colors, counters, completion days, and reminders.</li>
<li>Break-reminder settings, activity/idle timing state, and break statistics.</li>
<li>App preferences, downloaded audio, cached social results, and import or export state.</li>
<li>Lumi conversation history and online AI agreement; your provider configuration and API key if you set up your own provider.</li>
<li>If you enable sync, your account identifier, public and private key material, server address, and authentication state.</li>
</ul>
<p>You can use the app's data controls, your browser's site-data controls, or your operating system's app settings to remove local data. Backups you exported remain wherever you saved them.</p>
@@ -116,6 +117,17 @@
<p class="policy-kicker">06 · Connected services</p>
<h2>What happens when you connect another service.</h2>
<div class="policy-service-grid">
<article>
<h3>Lumi's optional online AI</h3>
<p>Lumi starts offline. Online AI requires agreement in the app. Requests include your message, up to three earlier chat messages, and a limited summary of your habits, tasks, settings, open screen, running practice and local time. Information Lumi reads to answer you, such as a diary entry, may also be sent. The agreement lists the context and limits before you choose to connect.</p>
<p>With Inner Breeze's service, requests go over HTTPS to api.waozi.xyz through Cloudflare, then to Z.ai's GLM model. Z.ai does not receive your Inner Breeze account ID or your IP address from this route. Its terms govern what it retains. Inner Breeze's service does not store or log AI message, context or answer text; it keeps daily request counts with your account ID and date.</p>
<p>With your own compatible provider, chat requests go directly from your device to the provider you configured, with your API key. The key and provider agreement remain on this device. That provider's privacy and retention terms apply. Diary spelling checks and habit icon suggestions still use Inner Breeze's service, sending the text needed for the requested task and counting these requests per account and day.</p>
<p>You can switch Lumi offline or withdraw agreement in Lumi's settings. The service agreement syncs to your account's other devices; your own provider's configuration and agreement stay local.</p>
</article>
<article>
<h3>Feedback and Telegram</h3>
<p>Feedback you confirm is sent with your account ID and app, device and system details so the developer can read and answer it. If you link Telegram, messages you send Lumi there are kept by Inner Breeze's service too. These records remain until you delete your account; a developer's copy may remain afterwards. Service backups retain copies for about a month. Telegram also handles messages under its own terms.</p>
</article>
<article>
<h3>Health Connect</h3>
<p>On supported Android devices, you can grant permission to export completed session start and end times and the practice type to Health Connect. Inner Breeze requests write access; it does not use Health Connect to read your other health records.</p>
@@ -125,8 +137,8 @@
<p>If you enable push on Android, your chosen provider—such as a UnifiedPush distributor or Google Firebase Cloud Messaging—may process an app/device registration token or endpoint and delivery information under its own privacy terms.</p>
</article>
<article>
<h3>Purchases and donations</h3>
<p>Optional purchases or donations are handled by the store, payment service, wallet, or website you choose. Those providers process payment and transaction data under their own terms. Their records are separate from Inner Breeze sync data.</p>
<h3>Purchases and project support</h3>
<p>Optional purchases, or voluntary support through the project's links, are handled by the store, payment service, wallet, or website you choose. Those providers process payment and transaction data under their own terms. Their records are separate from Inner Breeze sync data.</p>
</article>
<article>
<h3>Website and downloads</h3>
@@ -150,7 +162,7 @@
<section id="choices" class="policy-section">
<p class="policy-kicker">08 · Your choices</p>
<h2>You remain in control.</h2>
<p>You can use the core app offline, leave sync disconnected, avoid creating an alias or adding friends, decline notification and Health Connect permissions, choose not to purchase or donate, export your data, and delete local or remote copies. Children should use optional online features with the involvement of a parent or guardian where required by applicable law.</p>
<p>You can use the core app offline, leave sync disconnected, keep Lumi offline, withdraw online AI agreement, avoid creating an alias or adding friends, decline notification and Health Connect permissions, choose not to purchase, export your data, and delete local or remote copies. Children should use optional online features with the involvement of a parent or guardian where required by applicable law.</p>
</section>
<section id="contact" class="policy-section policy-contact">
@@ -169,7 +181,7 @@
<footer>
<a class="brand" href="/"><img src="/assets/editorial/lotus.svg" width="24" height="24" alt=""><span>Inner Breeze</span></a>
<p>Local first. Open source.</p>
<div><a href="/">Home</a><a href="/delete-account">Delete sync account</a><a href="https://git.sr.ht/~waozi/inbe">Source</a></div>
<div><a href="/">Home</a><a href="/delete-account">Delete sync account</a><a href="https://github.com/waozixyz/inbe">Source</a></div>
</footer>
</body>
</html>