Repository navigation
Releases: kajeesan/Open-Health-Atlas
Release list
Open Health Atlas 0.2.9 — dashboard priorities (Mac preview)
The Dashboard now starts with Day ratings and Habits & streaks, directly below the greeting. What is associated with your Green days is the final card, after the body and sleep charts. Desktop, mobile and keyboard reading order agree.
This update moves the existing sections intact. Their controls, chart data, links and calculations are preserved. The browser demo, landing-page screenshot and GitHub README also reflect the new order.
Download openhealthatlas-0.2.9-macos-arm64-signed-notarized.dmg for Apple silicon Macs. The app and disk image use Developer ID signing and Apple notarization. The exact corresponding source archive, application ZIP, SHA-256 checksums and verification receipt accompany the installer.
Validation: required CI passed on Python 3.11 and 3.12. The Python 3.12 run confirmed 2,173 application/toolkit tests, 15 fictional journeys and 5 MCP protocol tests. Locally, 71 focused shell/API/browser tests and 34 privacy-scanner tests passed. Desktop and mobile order checks, installed-app lifecycle and MCP checks, signature/notarization/Gatekeeper checks, and the bundle audit passed. A copy downloaded from GitHub matched the tested installer SHA-256.
This remains a Mac preview. Clean-Mac installation and the minimum supported macOS are not newly qualified by this layout update. Quit the app before replacing it; existing records and settings live outside the app bundle.
Source: 430d42c6f9da06aef34498e88df557b614230558.
Open Health Atlas 0.2.8 — sleep duration dashboard (Mac preview)
The dashboard now has a sixth card: Sleep duration · 14 days. It shows a nightly bar chart, the average across recorded nights, data coverage, and a Recovery link. Missing nights stay blank, and duplicate sources follow the Recovery page's source preference.
Download openhealthatlas-0.2.8-macos-arm64-signed-notarized.dmg for Apple silicon Macs. The app and disk image are Developer ID signed and accepted by Apple notarization. The ZIP, exact corresponding source archive, and SHA-256 checksums are attached.
The browser demo and landing-page dashboard image also show the new card.
Validation: 2,173 application/toolkit tests plus 20 separate fictional journey/MCP tests passed. Desktop and mobile browser checks passed. Packaged lifecycle/MCP checks and the bundle privacy audit passed. The final installer passed signature, notarization-ticket, and Gatekeeper checks; the app installed from that disk image also passed lifecycle and MCP checks. The uploaded installer was downloaded again and matched the tested SHA-256.
This remains a Mac preview. Installation on a clean Mac and other supported macOS versions have not been newly qualified by this release. Existing records and settings live outside the app bundle; quit the app before replacing it. AI-client setup is optional and separate.
Source: 85e16bb9691152b9bae9b256efd930c6cfabefd0. The attached source archive is the exact source included in the app.
Open Health Atlas 0.2.7 — guided AI setup (Mac preview)
Open Health Atlas 0.2.7 is a Mac preview for Apple silicon with a simpler guide for connecting your AI.
What changed
- Start with Copy setup instructions and let a local desktop agent help configure the connection.
- Choose I need help for manual instructions, one step at a time, or It's connected to check the connection.
- Expanded setup instructions now wrap and scroll inside their box. The confusing agent-capability section has been removed.
- Installation and AI-connection documentation now match the app.
The primary guide supports ChatGPT Desktop clients with local MCP settings. A setup agent needs access to local files and tools; copying the message into a browser or phone chat cannot install a local connection. Other compatible AI clients have a secondary setup route. The app does not configure another client automatically, and clicking It's connected does not itself verify a connection.
Download and update
Download openhealthatlas-0.2.7-macos-arm64-signed-notarized.dmg, open it, and drag Open Health Atlas into Applications.
Before replacing an existing app, quit Open Health Atlas and disconnect connected AI clients. Keep a private backup of your workspace. Replace the app, open your workspace successfully, then reconnect the clients. Records and settings are stored outside the app bundle.
Try the guide with fictional records first. Sharing personal records with an AI requires your approval.
Verification and scope
- Developer ID signing, Apple notarization and stapling passed for both the app and DMG. Default Gatekeeper assessments passed on the build/test Mac.
- The app copied from the final DMG passed 14 offline lifecycle/data checks and nine actual MCP client/server checks using fictional workspaces, including disconnect cleanup and reconnect behavior.
- Native inspection on macOS 26.6.2 arm64 verified fictional setup, the agent-first guide, copy feedback for both instruction messages, manual fallback and Back navigation, and the fixed instruction-box wrapping and scrolling. The existing full-setup section remained accessible, and the app quit cleanly.
- An actual packaged-runtime upgrade from the published 0.2.6 app preserved a fictional workspace's canonical records across 69 tables, five panel settings and recovery backups, including after restart.
- All 3,145 regular files in the tested app remained unchanged, and its signature, notarization ticket and Gatekeeper assessment passed again after testing.
- Repository checks and macOS desktop CI passed on the exact release source commit: 2,098 application tests, 15 fictional end-to-end tests and five actual MCP tests (2,118 distinct passes).
An initial MCP verification attempt could not inspect worker cleanup inside an additional test sandbox. The established local verifier then passed all nine checks, including cleanup. No application change was required.
This is a prerelease, not a stable-release qualification. Clean-Mac browser installation and the minimum supported macOS version remain unverified. Actual ChatGPT account configuration was not tested as part of release qualification. No Intel Mac, Windows or Linux desktop installer is included. Normal Gatekeeper protection should remain enabled. The previous preview remains available.
Source and licensing
Exact source: dbebf48a383790d3637a3902bf0a7b289a0dadc8.
The matching source archive, checksums and redacted build/acceptance receipts accompany the installer. The app also includes its corresponding source and license notices for offline access.
Setup guide · Local AI connection · Licensing
Original code and artwork: © 2026 Kajeesan Jeevendra, AGPL-3.0-only. Third-party components retain their own terms. Never post health records, private connection settings or credentials in public support reports.
Open Health Atlas 0.2.6 — Modular toolkit Mac preview
Open Health Atlas 0.2.6 is a signed Mac preview for Apple silicon, built from the completed toolkit modularization on main.
What changed
- Imports, nutrition, training, recovery, laboratory work and command coordination now have dedicated modules. The existing dashboard and command-line entry point remain available.
- Includes the reviewed date and numerical-boundary corrections made during the modularization plan.
- Removes obsolete internal command-routing helpers while preserving the inspected application callers and all 122 CLI commands.
This release mainly improves the code's organization and maintainability. It does not introduce a redesigned interface or promise faster calculations. Optional AI clients, collectors and other integrations remain separate, deliberate setups.
Download and update
Download openhealthatlas-0.2.6-macos-arm64-signed-notarized.dmg, open it, and drag Open Health Atlas into Applications.
Before replacing an existing app, quit Open Health Atlas and disconnect connected AI clients. Keep a private backup of your workspace. Replace the app, open your workspace successfully, then reconnect the clients. Records and settings are stored outside the app bundle.
Verification and scope
- Developer ID signing, Apple notarization and stapling passed for the app and DMG. Default Gatekeeper assessments passed on the build/test Mac.
- The DMG-installed app passed 14 offline lifecycle/data checks and nine actual MCP client/server checks using fictional workspaces.
- Native inspection on macOS 26.6.2 arm64 verified fictional setup, dashboard findings, Body maps and a chart, both help/setup sections, Back navigation, theme persistence after restart, license display and export of the exact corresponding-source archive.
- The mounted disk image's app, Applications shortcut and installation layout were checked in Finder.
- An actual packaged-runtime upgrade from the published 0.2.5 app to 0.2.6 preserved a fictional workspace's canonical health-table records and panel preferences, verified recovery backups, and retained those records/settings after restarting. This was tested on the development Mac, not a clean customer machine.
- Repository checks and macOS desktop CI passed on the exact merged source commit. The reviewed source tree also passed all 2,115 application, end-to-end and MCP test identities before merge.
This is a prerelease, not a stable-release qualification. Clean-Mac browser installation and the minimum supported macOS version remain unverified. No Intel Mac, Windows or Linux desktop installer is included. Normal Gatekeeper protection should remain enabled. The previous preview remains available.
Source and licensing
Exact source: 8eccebe15977e729653c0b7a9944f9ddba6b1a12.
The matching source archive, checksums and redacted build/acceptance receipts accompany the installer. The app also includes its corresponding source and license notices for offline access.
Setup guide · Local AI connection · Licensing
Original code and artwork: © 2026 Kajeesan Jeevendra, AGPL-3.0-only. Third-party components retain their own terms. Never post health records, private connection settings or credentials in public support reports.
Open Health Atlas 0.2.5 — Simple setup and photo themes
Open Health Atlas 0.2.5 is a Mac preview for Apple silicon with simpler setup, return navigation, and the previously reviewed photo themes and logo.
What changed
- Connect AI: one Copy setup instructions button combines the instructions with the selected workspace's real connection configuration. View connection settings shows exactly what will be copied. Separate download/copy-settings/first-question buttons are removed from this page; the underlying configuration API remains compatible.
- Full experience setup: a prominent second tab lists Hevy, Google Health and Cronometer first. Hostinger VPS, Hermes agent and Telegram are grouped under Advanced setup. Cronometer is a supported daily-summary CSV import, not a live API connection.
- Back navigation: Help and workspace switching return to the calling app page. First-run Help returns to setup when no workspace is open. External return URLs are refused.
- Themes and branding: ships Paper, Ember, Forest Verdant, Black Beach, Blue Glacier, Canyon Creek, El Capitan and Cyberpunk, with responsive photo backgrounds and the official theme-coloured Personal Contour Mark. New theme choices persist across restarts. Retired theme selections fall back to Paper.
The theme/logo edits were previously only in a separate older checkout. This release ports the selected changes into the current desktop source without importing that checkout's history or unrelated files. Optional services remain deliberate separate setups; installation does not activate integrations, schedules or hosting.
Install or update
Quit Open Health Atlas and disconnect any connected AI clients before replacing the app. Keep a private backup of your workspace folder. Download the signed-notarized macos-arm64 DMG, drag the app into Applications, then open your workspace successfully before reconnecting your AI. Your records remain outside the application bundle.
To connect an AI, open Desktop help & AI connection, choose Connect AI and use Copy setup instructions. The copied text includes local paths but no health records or credentials. The AI client may later send returned records to its model provider; approve that choice before connecting personal data. The health MCP connection remains read-only.
Source and scope
Exact source: 16fe07165282489a3057c7fb5d43dcb45724fe43.
Start here · Full experience setup
This is a prerelease, not a stable-release qualification. Verification used macOS 26.6.2 arm64. Clean-Mac browser installation and minimum supported macOS remain unverified. No Intel Mac, Windows or Linux desktop installer is included. The previous release remains available.
Original code and artwork: © Kajeesan Jeevendra, AGPL-3.0-only. Third-party work, including the attributed El Capitan source photograph, retains its separate terms. Matching source, checksums and redacted receipts accompany the installer. Never post health records, private connection settings or credentials in public support reports.
Verification
- Exact app and DMG passed Developer ID signatures, Apple notarization, stapling and default Gatekeeper checks.
- The installed runtime passed 14 offline lifecycle/data checks and nine real MCP checks. All 3,081 bundled files remained unchanged, with zero audit findings.
- An actual 0.2.4-to-0.2.5 upgrade with an isolated test record preserved all health-table rows, safely handled a retired theme, and retained a new photo theme after restart. Both setup tabs, Back links, all twelve photo assets and the configuration endpoint passed this installed-runtime check.
- Targeted source tests, nine JavaScript interaction scenarios, guide links, image metadata and logo-geometry checks passed. Browser inspection used fictional records and an isolated desktop broker for wide/narrow layouts, copying, Back navigation and all eight themes. A native dashboard launch was observed; native help interactions are not separately claimed for this artifact.
- macOS packaging CI and repository CI both passed on this exact source commit before publication.
DMG SHA-256: 4e23a980b8d9a32d6664f325d73fb4b3532f3d7ab21b66996662e391a34a1049.
Open Health Atlas 0.2.4 — Guided AI setup preview
Open Health Atlas 0.2.4 is a Mac preview for Apple silicon (M1 or newer) with a clearer Help & AI connection page.
What changed
- A three-step guide: choose records, add your AI connection, then ask a first question.
- Shorter explanations, theme-aware styling and layouts checked at wide and narrow window sizes.
- Expandable connection help, backup instructions and support information.
- Copyable setup-agent instructions for Hermes, Telegram, Google Health, Hevy and Hostinger VPS hosting.
- Nontechnical installation and setup guides in the matching source. Optional services remain separate, deliberate setups; this release does not enable them automatically.
The installed app's Download settings action exports its selected workspace's real MCP configuration. The screenshot/design preview used during development is not that connection. MCP remains read-only, and an AI client's configured provider may receive returned records.
Install or update
- Back up your existing workspace folder. Quit Open Health Atlas and disconnect AI clients before replacing an older app.
- Download the signed-notarized macos-arm64 DMG, open it, and drag Open Health Atlas to Applications.
- Open the app and your workspace successfully, then reconnect your AI client. Export new settings if you changed the workspace, timezone or app location.
Records remain outside the application bundle. Replacing the app does not replace your records. You do not need an AI account, developer tools or Terminal for the dashboard. External providers and hosting have their own setup, fees and privacy policies.
Release scope
This remains a prerelease. Clean-Mac installation and the minimum supported macOS remain unverified. There is no Intel Mac, Windows or Linux desktop installer in this release. Existing preview qualification limits are unchanged.
Exact source: 55d2dae5ba9910ebe1bef3c3b923e97dc25cdde7.
Start here · Optional integrations
The installer, app ZIP, matching source archive, checksums and redacted build receipt accompany this release. Original code and artwork: © Kajeesan Jeevendra, AGPL-3.0-only. Third-party components retain their licenses and notices. Report problems using fictional data; never attach health records, credentials or connection configuration to public reports.
Verification of this artifact
- App and DMG Developer ID signatures, Apple notarization, stapling and Gatekeeper checks passed.
- The exact DMG-installed app passed 14 offline lifecycle/data checks and 9 real MCP checks. All 3,068 bundle files remained unchanged; the bundle audit found no privacy findings.
- The changed source passed 42 existing desktop/session/preferences/MCP/shell tests, six isolated clipboard/error-state checks and 28 packaging/scanner tests. Browser checks used fictional source data. The exact signed app also rendered the updated native help page and exported valid connection settings for an isolated fictional workspace; the export selected the correct installed MCP executable. All bundle files remained unchanged afterward.
- macOS packaging CI passed. Repository CI passed on the same source commit.
DMG SHA-256: 4821996de8d85482491ce5f6838c1af9c1d060cfe732bbda1a09d158e4816970.
Open Health Atlas 0.2.3 — Drag-to-Applications preview
Open Health Atlas 0.2.3 is a free preview for Macs with Apple silicon (M1 or newer).
The installer now opens in a compact, themed window with one app icon → Applications. Drag the app onto the Applications folder, then open it from Applications. The separate instruction file has been removed. The official Personal Contour Mark, local app features and workspace setup are retained.
Install
- Download the signed-notarized DMG below and open it.
- Drag Open Health Atlas onto Applications. Quit an existing app and connected AI clients before replacing an older installation.
- Open the app from Applications and choose fictional records, a new workspace, or a copy of a compatible Open Health Atlas database.
No signup, payment, Terminal commands, developer tools or AI account are needed for the core app. Records remain outside the application bundle, on your computer. License, corresponding source and third-party notices are available from the app menus.
Preview status
Developer ID signed, Apple notarized and stapled. Native verification was performed on macOS 26.6.2. Installation on a clean Mac and the minimum supported macOS remain unverified; this is a prerelease, not a stable-release qualification claim. There is no Intel Mac, Windows or Linux installer in this release.
Optional external AI clients require separate setup and may send requested records to their chosen model provider. Their privacy settings and fees apply independently.
Source and verification
The exact DMG-installed app passed 14 offline lifecycle/data checks and 9 real MCP checks. All 3,066 bundled files remained unchanged, with no release-scan findings. The macOS packaging workflow passed. The broader repository workflow is still running at publication preparation; its completion is a separate CI result, not claimed here.
DMG size: 39 MB. SHA-256: 41ea3ec6a868f6243e2f64ec062b7959e65e5027ef9d370dff4ff54ccf053b32.
Exact source: 5db136edc0b19dbc0e2a319927fd9bf4cd612ff1.
The release includes the DMG, an optional app ZIP, exact corresponding source, checksums and a build receipt. The installer build verifies the signed app inside the mounted image, the Applications shortcut and the two visible items before notarizing the DMG. Standard and Retina backgrounds are generated from the included source.
Original code and artwork: © Kajeesan Jeevendra, AGPL-3.0-only. Bundled third-party components retain their own notices and licenses. Please report problems using fictional records only; never post personal health records or credentials in public issues.
Open Health Atlas 0.2.2 — Mac preview
Open Health Atlas 0.2.2 is a free preview for Macs with Apple silicon (M1 or newer). It includes the official Personal Contour Mark, a clearer first-run screen with a visible Continue button, and a bundled runtime.
Download and install
Choose openhealthatlas-0.2.2-macos-arm64-signed-notarized.dmg below (53 MB).
- Open the downloaded DMG.
- Drag Open Health Atlas into Applications.
- Open the app and choose fictional records, a new personal workspace, or a copy of a compatible Open Health Atlas database.
The core app needs no Terminal commands, developer tools, signup, payment or AI account. Records are stored outside the app bundle, on your computer. Quit the app and any connected AI clients before replacing an existing installation.
Preview status
The app and DMG are Developer ID signed, Apple notarized and stapled, and passed local Gatekeeper checks. Native installation and operation were tested on macOS 26.6.2; packaged automated checks also ran on macOS 15. This does not establish a minimum supported macOS. Ordinary browser-downloaded installation on a clean Mac and wider platform qualification remain open. There is no Intel Mac, Windows or Linux installer in this release.
This is a prerelease from the reviewed desktop branch, not a claim that stable-release qualification or protected main-branch integration is complete.
What is included
- Local records, dashboards and deterministic calculations.
- Guided workspace setup and an option to explore fictional records first.
- An optional bundled MCP connection for a compatible external AI client. That client has separate setup, privacy settings and possible fees; records requested through it may be sent to its model provider.
- The official Open Health Atlas logo in the app icon and SVG master.
Patterns help you inspect your records; they do not establish causes or replace medical care. Import support depends on the source and format; this release does not automatically connect to every wearable or support every AI client.
Verification and source
Current-source CI passed: 2,020 application checks, 15 fictional end-to-end checks and 5 MCP integration checks. The signed DMG-installed app also passed 14 offline checks and 9 real MCP checks, with 3,066 bundled files unchanged and no findings in the release privacy scan.
The DMG SHA-256 is 90d1d8928a57c6edf20595b18d16ce5a01b3a320a7a444f7ff4783ff8101e5e6. The attached SHA256SUMS file covers the DMG, optional app ZIP and corresponding source ZIP.
Exact source: e2103be577d08817e83bfb234f5e49ee0824e313. Original code and artwork: © Kajeesan Jeevendra, AGPL-3.0-only; bundled third-party components retain their notices and licenses. Corresponding source is both attached and included in the app.
Please use fictional records when reporting issues and never post personal health records, credentials or private contact information in public reports.
Open Health Atlas v0.1.0
Open Health Atlas v0.1.0
Created by Kajeesan Jeevendra.
The initial public source release of Open Health Atlas: a local-first,
single-user health-data application with deterministic analytics, traceable
evidence and optional model-agnostic MCP access.
Included
- Local dashboard, supported imports and validated record-entry tools.
- Deterministic calculations with source, time, unit and missing-data context.
- Read-only local MCP tools for discovery, queries, background analysis and evidence verification, using the model configured in the user's MCP client.
- Existing integration code for separately configured Hermes and Telegram workflows.
All 1,981 retained tests passed, including actual MCP client/server
subprocess checks. The published runtime, tests and dependencies match that
verified version. Publication changes cover the MIT license, creator credit,
documentation and clean Git history.
Getting started
Follow the README
or the local MCP guide.
The attached ZIP is a source package, not a desktop installer. Local MCP
currently supports macOS and Linux. Model access and external integrations
are configured separately.
License and attribution
Original project code is licensed under MIT, with copyright credited to
Kajeesan Jeevendra. Third-party components retain their original licenses
and notices. See LICENSE, NOTICE, CITATION.cff and THIRD_PARTY_NOTICES.md.
Source archive
Open-Health-Atlas-v0.1.0-source.zip
SHA-256: 36a1da61e976e68e5311447e7d014c1de11b7ba269da4b8ae0b5a7076b62eb17
This is a developer preview. Known capability and platform limits are
documented in the repository. No personal health records, credentials or live
deployment configuration are included.