{"id":14985138,"url":"https://github.com/allenporter/home-assistant-journal-assistant","last_synced_at":"2025-07-10T17:33:40.655Z","repository":{"id":256312381,"uuid":"854912661","full_name":"allenporter/home-assistant-journal-assistant","owner":"allenporter","description":"Journal Assistant for Home Assistant","archived":false,"fork":false,"pushed_at":"2025-07-04T03:08:40.000Z","size":449,"stargazers_count":4,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-04T04:21:48.527Z","etag":null,"topics":["bullet-journal","home-assistant","supernote"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/allenporter.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2024-09-10T01:23:40.000Z","updated_at":"2025-07-04T03:08:43.000Z","dependencies_parsed_at":"2024-11-30T02:30:32.864Z","dependency_job_id":"3a91cf18-f255-4c16-899d-f0de30cf092e","html_url":"https://github.com/allenporter/home-assistant-journal-assistant","commit_stats":{"total_commits":76,"total_committers":2,"mean_commits":38.0,"dds":0.1578947368421053,"last_synced_commit":"cff89b533a7be5fc23856e5c5fdcc7d008030de2"},"previous_names":["allenporter/home-assistant-journal-assistant"],"tags_count":17,"template":false,"template_full_name":null,"purl":"pkg:github/allenporter/home-assistant-journal-assistant","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allenporter%2Fhome-assistant-journal-assistant","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allenporter%2Fhome-assistant-journal-assistant/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allenporter%2Fhome-assistant-journal-assistant/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allenporter%2Fhome-assistant-journal-assistant/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/allenporter","download_url":"https://codeload.github.com/allenporter/home-assistant-journal-assistant/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/allenporter%2Fhome-assistant-journal-assistant/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":264619683,"owners_count":23638499,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bullet-journal","home-assistant","supernote"],"created_at":"2024-09-24T14:10:22.259Z","updated_at":"2025-07-10T17:33:40.650Z","avatar_url":"https://github.com/allenporter.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# home-assistant-journal-asssistant\n\nA multi-modal notebook processor for a Bullet Journal.\n\n## Overview\n\nThis is a Home Assistant custom component spanwed out the effort to\nexplore using a [Supernote](https://supernote.com/) e-ink tablet using a [Bullet Journal](https://www.youtube.com/watch?v=fm15cmYU0IM) plus\nLLM understanding to develop a personal assistant. This integration will:\n\n- Take as input a media source path and a multi-modal conversation agent\n- Process the media source with a set of dynamic prompts\n- Expose a parsed RFC5545 JOURNAL as a calendar entity\n\nSee https://github.com/allenporter/supernote-llm\n\n## Development plan\n\n- [x] Initial dummy calendar\n- [x] Create monthly journal entity\n- [x] Create weekly journal entity\n- [x] Create daily journal entity (tasks?)\n- [x] Create other journal entries by date created\n- Given a directory of notebook yaml contents:\n  - [x] Read the notebook file\n  - [x] Read through notes grouped by date\n  - [x] Check for journal entry on date\n  - [x] Create journal entry if it does not already exist\n  - [x] Add content to the journal entry\n- [x] Test out monthly review\n- [x] Test out monthly rapid log\n- [x] Test out weekly review\n- [x] Test out weekly rapid log\n- Documentation\n  - [ ] Update with a screenshot of current state\n  - [ ] Diagram with the workflow involved\n  - [ ] Explanation of LLM prompts and details on bullet journal formats\n- Processing\n  - [x] conversation agent in config flow\n  - [x] Create output storage directory for yaml\n  - [x] Storage area for dynamic prompts\n  - [x] Multi-modal call that outputs yaml structured output\n  - [x] (re)process a media uri on demand\n  - [x] Structured output =\u003e Journal demo\n- State management\n  - [x] Metadata store of media source uri sources\n  - [x] Compute hashes of media source content to determine changes\n  - [ ] Persist journal in .ics\n  - [x] Merge existing journal contents with ingested processed media\n  - [ ] etag support\n- Visibility\n  - [x] Entities associated with a device service\n  - [x] Sensors exporting diagnostic information like last time processed\n  - [x] Sensor exporting # of journal entries\n- Journal Entity\n  - [ ] Update tests to use service calls for reads\n  - [ ] Support for additions to a journal (calendar)\n  - [ ] Support for writes to a journal (calendar)\n  - [ ] Support for edits to a journal (calendar)\n- Assistant API\n  - [x] Add journal entities to the prompt\n  - [x] Add vector search intent\n  - [ ] Calendar search intent\n- Vector search\n  - [x] create db at starts\n  - [x] Query database from tool end to end test\n  - [x] persistence of database\n  - [x] understand embedding functions\n  - [x] support deleting documents and removing from index\n  - [ ] support more google models in config flow\n  - [ ] support alternative embedding models\n  - [ ] delete tenant on integration removal\n- [x] support reload of config entries\n- [x] support removing config entries, cleaning up database\n- [x] make vetordb indexing asynchronous\n- [x] reload vector db after updating index\n- [x] sensor for # of raw yaml files in total\n- [x] sensor for # of pages for each notebook prefix\n- [x] sensor with processor counts of total # of processed (total_increasing?)\n- [x] monthly/quarterly reflections not showing up, check on details\n- [x] Swap local vectordb interface\n- [x] Support local vectordb persistence\n\n## Local Development\n\n### Pre-requisites\n\n```bash\n$ uv venv\n$ source .venv/bin/activate\n$ uv pip install -r requirements_dev.txt\n```\n\n### Prepare Home Assistant\n\n```bash\n$ export PYTHONPATH=\"${PYTHONPATH}:${PWD}\"\n$ hass -c /workspaces/config --script ensure_config --prerelease=allow\n```\n\n### Run Home Assistant\n\nFrom then on run home assistant:\n\n```bash\n$ hass -c /workspaces/config\n```\n\nRunning with multiple custom components\n\n```bash\n$ cd /workspaces/config\n$ ln -s ../../home-assistant-supernote-cloud/custom_components/supernote_cloud custom_components/supernote_cloud\n$ ln -s ../../home-assistant-journal-assistant/custom_components/journal_assistant custom_components/journal_assistant\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fallenporter%2Fhome-assistant-journal-assistant","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fallenporter%2Fhome-assistant-journal-assistant","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fallenporter%2Fhome-assistant-journal-assistant/lists"}