5 Releases 5 Tags

RSS Feed

• v1.0.4 70b0cf08ee

  Compare

  Release v1.0.4 Stable

  tliu93 released this 2026-06-01 21:36:23 +02:00 | 1 commits to main since this release

  Highlights

  This release adds three major capabilities:

  • Alembic-based database migrations
  • LLM settings and an OpenAI-compatible client
  • Basic AI-powered search

  AI search is implemented as query expansion plus local LIKE search. It only sends the user’s search query to the LLM,
  not the inventory contents.

  New Features

  Database Migrations

  • Added Alembic as the official schema migration system.
  • Added an idempotent migration command:

  python -m app.migrate

  • Supports:

    • Creating schema for an empty database
    • Adopting an existing legacy three-table database as the V1 baseline
    • Upgrading managed databases to head
    • Failing closed when an unmanaged schema does not match the expected baseline

  • App startup now performs read-only schema verification and refuses to start if the database is not at the expected
    revision.

  LLM Settings

  • Added a /settings page.

  • Added support for:

    • LLM master toggle
    • Base URL
    • Model name
    • API key
    • AI search toggle
    • Optional extra AI-search domain hints

  • Added a connection test action.

  • API keys are not echoed back in the UI.

  • Leaving the API key field blank keeps the existing key.

  • Changing the Base URL requires entering a fresh API key.

  AI Search

  • Added an “AI Smart Search” action to the search page.

  • The action is visible only when LLM is configured and AI search is enabled.

  • AI search expands the user’s query through the LLM, then searches Box, Item, and SubItem name / note fields using
    the original query plus expanded terms.

  • Search results show the expanded terms when AI search is active.

  • LLM failures fall back to normal search and show a friendly error message.

  • Empty or invalid LLM output falls back to normal search without breaking the page.

  Upgrade Notes

  This release introduces Alembic. The database must be migrated before the app starts, otherwise startup will fail
  closed.

  Recommended deployment flow:

  Back up data/app.db first

  docker compose pull web
  docker compose run --rm web python -m app.migrate
  docker compose up -d

  For local development:

  python -m app.migrate
  python -m pytest tests/ -q

  Data and Security

  • Added the app_settings table for LLM configuration.
  • API keys are stored in plaintext in the database by design, but are not displayed in the UI.
  • AI search sends only the search query and prompt context to the configured LLM endpoint.
  • Inventory contents, notes, and images are not sent to the LLM by AI search.
  • OCR, image recognition, vector search, and semantic indexing are not included in this release.

  Tests

  The release adds and updates tests for migrations, settings, the LLM client, and AI search.

  Validation result:

  226 passed

  Known Limitations

  • AI search v1 is not vector or semantic search; it is LLM query expansion plus local fuzzy matching.
  • LLM output must satisfy the JSON string-array contract. Invalid output is treated as an empty expansion.
  • Docker startup does not automatically run migrations. Deployments must explicitly run python -m app.migrate.

  Downloads

  • Source Code (ZIP)
  • Source Code (TAR.GZ)
• v1.0.3 facf82c898

  Compare

  Release v1.0.3 Stable

  tliu93 released this 2026-04-27 20:44:28 +02:00 | 7 commits to main since this release

  Add summary

  Downloads

  • Source Code (ZIP)
  • Source Code (TAR.GZ)
• v1.0.2 22ea44d8cd

  Compare

  Minimal Installable PWA Support Stable

  tliu93 released this 2026-04-23 15:27:31 +02:00 | 12 commits to main since this release

  This release adds minimal, low-risk PWA support to Moving Helper without changing the existing FastAPI + Jinja SSR architecture.

  What’s included:

  Added a manifest.webmanifest with app name, theme color, background color, standalone display mode, and install icons
  Added a minimal root-scoped service-worker.js for install compatibility
  Updated the base template to include manifest, theme color, mobile web app meta tags, and Apple touch icon support
  Added install icons for Android, iPhone/iPad home screen usage, and desktop app installation flows
  Documented deployment notes and validation steps for PWA installation
  Added automated tests for manifest delivery, service worker delivery, and template PWA metadata
  What this enables:

  Android Chrome can add the app to the home screen
  iPhone Safari can add the app to the home screen
  Desktop Chrome / Edge can install the app as a standalone window

  What this does not include:

  Offline support
  Offline caching strategies
  Offline sync
  Any frontend framework migration or SPA rewrite

  Downloads

  • Source Code (ZIP)
  • Source Code (TAR.GZ)
• v1.0.1 49a5452141

  Compare

  Release 1.0.1 Stable

  tliu93 released this 2026-04-21 22:40:42 +02:00 | 14 commits to main since this release

  Bug fix on css loading with https

  Downloads

  • Source Code (ZIP)
  • Source Code (TAR.GZ)
• v1.0.0 d39c1933b4

  Compare

  Working release 1.0.0 Stable

  tliu93 released this 2026-04-21 21:55:21 +02:00 | 16 commits to main since this release

  Downloads

  • Source Code (ZIP)
  • Source Code (TAR.GZ)