A local-first personal AI agent for Android with permanent memory, scheduled autonomous tasks, self-written mini-apps, and an optional home-screen launcher.
- Stars
- 220
- Forks
- 16
- Open issues
- 0
- Last commit
- yesterday
What is it?
Hermes Life OS is a personal tracking and reflection assistant that stores your mood, sleep, meals, stress, focus, habits and other daily data in local memory. It runs on a schedule to send morning, midday, evening and weekly briefings, and it computes same-day and lagged correlations between metrics such as sleep and mood, so insights are based on your own logged history.
You can interact with it through a CLI, an interactive chat mode, voice, a local REST API, and Telegram, Discord, WhatsApp or Slack bots. It supports Anthropic, OpenAI, OpenRouter and local Ollama models, and optional encryption at rest. Data can be imported from Apple Health, CSV or ICS calendar files, and exported to JSON or CSV.
The project also includes a static HTML dashboard, a live web dashboard, a retrospective report, a contribution heatmap, and a plugin system for adding custom tools. It is installable from PyPI and can run in Docker.
Key features
- 01Stores mood, sleep, meals, stress, habits and other logs in local memory.
- 02Scheduled morning, midday, evening and weekly briefings.
- 03Pearson correlations between metrics, including lagged results.
- 04Chat, CLI, voice, REST API and Telegram, Discord, WhatsApp, Slack bot interfaces.
- 05Supports Anthropic, OpenAI, OpenRouter and local Ollama models.
- 06Optional encryption at rest and multi-profile data isolation.
Use cases
- Tracking daily mood, sleep and stress to find what affects your energy.
- Keeping a private, self-hosted journal and habit log without sending data to a cloud service.
- Importing Apple Health or calendar exports to see how meeting load relates to mood.
- Running a shared household profile setup with separate data per person.
Quick start
- 1
Install the package from PyPI with all extras
pip install "hermes-life-os[all]" - 2
Set an LLM backend: a provider API key, or run Ollama locally for a free, no-key option
- 3
Run first-time onboarding so Hermes learns who you are
hermes-life-os --mode onboard
Things to know
- Needs an LLM backend: an Anthropic, OpenAI or OpenRouter API key, or a local Ollama install.
- Hackathon project with a small user base (220 stars); expect rough edges.
Topics
FAQ
- What is hermes-life-os?
- Local-first personal OS agent built on Hermes that logs mood, sleep, meals and habits, then surfaces patterns across them over time. Hermes Life OS is a personal tracking and reflection assistant that stores your mood, sleep, meals, stress, focus, habits and other daily data in local memory. It runs on a schedule to send morning, midday, evening and weekly briefings, and it computes same-day and lagged correlations between metrics such as sleep and mood, so insights are based on your own logged history.
- Is hermes-life-os free to use? What license does it have?
- hermes-life-os is open source under the MIT license. Check the license terms before using it in commercial products.
- Is hermes-life-os still maintained?
- Actively maintained. The last commit to hermes-life-os was on Oct 21, 2026.
- What can I use hermes-life-os for?
- Tracking daily mood, sleep and stress to find what affects your energy. Keeping a private, self-hosted journal and habit log without sending data to a cloud service. Importing Apple Health or calendar exports to see how meeting load relates to mood. Running a shared household profile setup with separate data per person.
- How do I install hermes-life-os?
- Install the package from PyPI with all extras: pip install "hermes-life-os[all]" Set an LLM backend: a provider API key, or run Ollama locally for a free, no-key option Run first-time onboarding so Hermes learns who you are: hermes-life-os --mode onboard
- Where can I get hermes-life-os?
- The source code and installation instructions are on GitHub: https://github.com/Lethe044/hermes-life-os
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
A local-first personal AI assistant in readable Python, with its own agent loop, SQLite-based memory, and built-in evals.
A self-hosted personal AI agent where each agent runs in its own Linux desktop container on your computer, with any model, an encrypted vault and Telegram control.
A desktop and self-hosted AI agent that runs on your machine, executes shell commands and file edits in your projects, and generates Word, Excel, PowerPoint and PDF files.
Open-source AI personal assistant for planning, writing and personal knowledge, runnable on a Mac or self-hosted with your own model keys.
A Rust-based, local-first personal AI agent that runs tasks on your computer and chats through channels like Telegram, Discord, and Slack.