Repository navigation
The AI backend can now propose changes to the tree as dry-run transactions, which are applied only after the user approves them. Imports are more complete and report what they could not import.
With Gramps QL removed, GOQL by @dsblank is the only query language left in the API: in the MatchesQuery filter rule, the query endpoints and the AI assistant's filter tools. This brings two breaking changes for API clients, see below.
This release contains 26 pull requests by 7 contributors, two of whom contributed for the first time. Thank you all! 🎉
AI chat
- Change proposals. The assistant can propose adding, changing or deleting records. Proposals are dry-run and returned as a transaction, which Gramps Web applies only after the user approves it. Requires
LLM_ALLOW_WRITE_PROPOSALS(#1156, #1186). - Images. Users can attach images to a question, such as a scanned record, if the model supports them. Requires
LLM_VISION(#1184). - GOQL filtering. The assistant filters with GOQL queries and can answer questions like "which couples had five or more children?" (#1181).
Imports
Since 3.25, we have been making imports more complete and more transparent, so users know what was imported and what was not. Following #1161 in 3.25.3, this release brings:
- More complete GEDCOM 7 imports. With gramps-gedcom7 0.6.0, event participants such as witnesses, adoptive and foster relationships, residences and occupations as events, and citation dates and texts are imported (#1189).
- Complete import reports. GEDCOM 7 imports report what they left out and show progress, and warnings from Gramps' importers are no longer dropped (#1177). Truncated reports keep their end, where the GEDCOM importer lists records created for missing references (#1187).
- Media archives match by file name. Paths from other programs, like
C:\Users\…\grandpa.jpg, now matchgrandpa.jpgin the ZIP, and media without a file are listed (#1177).
Other improvements
- Relationship paths. A new endpoint finds the chains of people linking two people, including through marriages, by @dsblank (#1138).
- S3 media storage. With S3 as the media storage backend, exporting media as a ZIP archive no longer runs out of memory with large files such as videos (#1172).
- Bulk tagging and privacy. Tags and privacy can be set for many objects at once (#1162).
- Historical place names. Events show the name a place had at the event's date, by @jerive (#1073).
- Date formats. Profiles, search results, timelines and the anniversary feed can use any of the locale's date formats, by @Nazivon (#1154).
- DNA matches include their relationship distance (#1182).
- Filtering by association type and by referencing object type is faster (#1179).
User management
- Merging users. Site admins can merge two accounts of the same person, by @scotCW (#1148).
- Setting passwords. Owners and admins can set the password of a lower-ranked user, also with the CLI command
user set-password, by @jon99nelson-svg (#1157). - Single sign-on for native apps. Native apps can log in through the system browser, as some providers like Google require. This was contributed by @thobgg for gwAnd, his new Android app for Gramps Web (#1174).
- Clients can check whether registration is enabled (#1175).
Fixes
- AI chats run on the task queue are counted against the AI quota (#1183)
- An instance whose cache is not writable no longer sends a telemetry ping on every request (#1185)
- Uploaded files of failed imports are deleted (#1187)
- Imports into trees created from the Gramps example tree no longer fail in a fresh worker (#1188)
- Custom filters with an invalid GOQL query are rejected when created or updated, instead of failing each time they are applied, by @dsblank (#1180)
- Face detection on an empty file returns 422 instead of 500 (#1178)
Notes for administrators
With the standard Docker setup, no action is needed. New options:
LLM_ALLOW_WRITE_PROPOSALS: lets the AI assistant propose changes for users who may add, edit and delete objects. Adds about 3,300 tokens per model request for them (#1156).LLM_VISION: set if your model accepts images. Each image counts as one unit of AI usage (#1184).OIDC_ALLOWED_REDIRECT_URIS: redirect URIs native apps may use for single sign-on (#1174).
With pip, gramps-gedcom7 0.6.0 or newer is required (#1189).
Changes for API clients
Breaking changes announced in the roadmap; Gramps Web is not affected:
- Gramps QL is removed. The
gqlparameter is rejected with 422. Use theMatchesQueryfilter rule instead (#1153). - Query endpoints take GOQL strings only.
whereis replaced bywhere_expr,selectandorder_byentries are strings, and a newenvfield supplies values forEnv.NAME, by @dsblank (#1164).
Other changes:
- GOQL and filter errors return a short
messagewith details inmessages, by @dsblank (#1164, #1180). - Plain
GET /api/{type}/{handle}returns the object's own ETag, matchingIf-MatchonPUT, by @jerive (#1173). - New endpoints:
GET /relations/{handle1}/{handle2}/paths,POST /objects/edit-by-handle/,POST /users/{name}/merge/,GET /register/config/. POST /chat/acceptsimagesandprevious_proposaland can return aproposal, applied withPOST /transactions/(#1156, #1184, #1186).PUT /users/{name}/acceptspassword(#1157).- Media archive imports return a
not_foundlist (#1177).
New Contributors
Full Changelog: v3.25.3...v3.26.0