Skip to content

Releases

v1.6.0

Choose a tag to compare

@github-actions github-actions released this 15 Nov 21:08

Added

  • Update now: on an install without Docker, one button updates the app. It saves and checks a copy of the database first, runs the installer of the new release, and the page comes back by itself; other installs are shown their one command or step. A dot on Settings says a new version is out.
  • The owner sees on the setup screen when a newer release is out, with a link to what changed and how to update. The server asks GitHub at most twice a day and sends nothing about the archive; FOLKBRANCH_UPDATE_CHECK=off turns it off.
  • Spanish and Catalan as archive languages, in Settings → General and on the first screen. A word not yet translated shows in English, never in Russian. Dates such as "12 de marzo de 1890" and "5 d'abril de 1931" are read in search, birthdays and GEDCOM export, a search finds García as Garcia and understands "la esposa de Iván" and "la dona de l'Ivan", and the assistant and speech recognition take the archive's language. The fictional demo family is in English for both for now.
  • Settings → AI and models: one screen that shows what is connected (the assistant, cloud transcription, faces and voice on the device, stories by link), and one settings file for all of it. Download it, or load it into another archive: it holds no keys, says what it applied and what it could not and why.
  • OWNER_EMAIL in the server's environment puts the owner's address on their account, so "Sign in with Google" opens it with no link to open first. No other Google account gets in.
  • A check that no commit names an AI assistant as author or co-author: a commit-msg and a pre-push hook in .githooks, and a CI job.

Changed

  • A child with one parent on record is no longer called a stepchild of that parent's partner, since the partner may be the other parent: the chart says "husband's son" or "father's wife" instead. With the other parent on record as someone else, "stepson" and "stepfather" stay.
  • The check asks for a second parent when a brother or sister through the same parent has both on record.
  • In an English archive the years of a living person end in "now" on the server too (search, exports, the sheet), as on the screen.
  • Long relation labels on the chart wrap onto up to three lines within the card instead of running into the neighbours, and show whole under the cursor; the chart rows are a little taller for it.
  • A new archive opens straight on the chart with its first actions; what to set up next stays in Settings instead of a window over the first screen.
  • The connection check every 15 seconds runs only while the live line to the server is down.
  • OWNER_EMAIL sets the owner's address only over a stand-in or its own earlier value, so an address the owner chose in the app stays.

Fixed

  • Updating from 1.5.1 or older with the install command while a page of the app is open: the old version did not stop, the new one landed beside it, and the app was down once the page closed. The installer now ends a version that has not stopped in 30 seconds before it swaps the program.
  • Stopping or updating the app no longer hangs while a page is open: the server closes its live lines when told to stop, and the launcher ends a server that has not stopped within 10 seconds. Before, an update with a page open could swap the program under a server that was still running, and the app stayed down afterwards.
  • An agent's draft accepted after someone changed the same field no longer writes over that change: the draft waits with the reason, and facts and tags from both are kept.
  • English labels: the button that rejects a face guess reads "No", the card picker "Choose a card", and the assistant's hint names its button as it is.
  • Dependencies with known vulnerabilities: nodemailer 10.5 and a newer esbuild for drizzle-kit.

v1.5.1

Choose a tag to compare

@github-actions github-actions released this 09 Nov 09:15

The archives for installing without Docker now build and start on every system. Versions 1.2.0 to 1.5.0 came out without the archives for macOS and Windows; this is the first release that has all of them.

Fixed

  • The install command no longer hangs on macOS when the shell ignores a closed pipe, as on a build server: the random setup code is read from a finite piece of data.
  • The archive for Windows builds: a newer node-gyp finds Visual Studio, and the packages are laid out flat, so the picture library finds its DLLs and the archive holds no links back into the build folder.
  • The release workflow can be run by hand to build and try the archives on all five systems without publishing anything.

v1.5.0

Choose a tag to compare

@github-actions github-actions released this 15 Nov 19:57

The assistant's models are tested, cheap and kept current: a model the provider takes away is replaced by itself. The owner can pay for cloud speech so that everyone can dictate. A guide shows new people what the app does.

Added

  • A guide to what the app can do, shown to a new person on the first visit and kept under the settings' tips: short cards for the chart, the assistant, stories, voice, faces and the rest.
  • Cloud speech: the owner connects a speech service once (OpenRouter, Groq, OpenAI, Mistral, SiliconFlow or a server of their own) and pays for it. Every editor then dictates and transcribes recordings through the server, which keeps the key and keeps no recording. A monthly limit of minutes protects the wallet.
  • Stronger speech models on the device for English (Whisper small and turbo), beside GigaAM for Russian.
  • Each AI service is marked by how it is paid for (free or paid) and what happens to what you send, and a service we did not test is marked as not tested.
  • Models are recommended only where we tested them: 97 scenarios on an invented family, GPT-6 Luna by default, and only cheap and recent models offered. The results are in docs/MODEL_BENCHMARK.md.
  • The owner can leave the model on automatic: the newest model of a tested line that the provider lists is used, never an older one than the one tested.
  • A model the provider took away is replaced by another of the same line, or a tested one of the service. OpenRouter gets backup models, and speech services fall back to their other models.
  • docs/RELEASING.md: how a version is chosen and a release is cut, and a test that the version and the changelog agree.

Changed

  • A model is described in one plain sentence.

Removed

  • The old Qwen 3.6 model from the Cloud.ru list.

Fixed

  • DeepSeek and Kimi, used directly, no longer refuse a long conversation: their reasoning is sent back with the tool results.
  • A GEDCOM with a repeated or missing record id no longer stops the import, and one odd entry in a provider's list of models no longer empties the list.
  • A request a provider refuses is written to the server log with its cause, and the person is told that the provider may have changed its API.
  • The map falls back to a second free tile server, the engine and model files to a second mirror, and the browser's cache of app files stops growing with every release.

v1.4.0

Choose a tag to compare

@github-actions github-actions released this 09 Nov 08:23

Sign in with Yandex ID, VK ID, Telegram, Google or a code by mail; assistant providers in Russia and China; load a tree together with its photos, by merging or replacing; a clearer chart with menus.

Added

  • The model list is read from the provider itself, newest first, with a mark for models that see pictures (OpenRouter, Anthropic and Moonshot say so). A model that cannot see is not offered the scan-reading tool, and the owner is told.
  • Assistant providers in Russia and China: Yandex AI Studio, Cloud.ru (GigaChat, Qwen and others), DeepSeek and Moonshot (Kimi), chosen in the same list by region.
  • Ways to sign in besides a link, each switched on by the owner under Settings → Ways to sign in with its steps, the return address and a check before saving: Yandex ID, VK ID (also Mail.ru and Odnoklassniki accounts), Telegram, Google, and a six-digit code by mail. Relatives link the ones they like under My account and add their own email there. Keys typed in the app are kept encrypted; server variables still win. See docs/SIGN_IN.md.
  • Load a tree file in one of three ways: add to the family, merge with the people already there (the same person is found by name and dates and nothing is doubled), or replace everything. The dialog says beforehand how many people would be added, matched and linked.
  • Load a tree together with its photos and files: drop them in one go, and each picture is attached to the people it belongs to, by the file's own links, by the person's id in its name, or by name.
  • A right-click menu on the chart. On a person: open, add a parent, a spouse or a child, delete. On an empty place: add a person there, load a file, search, show everyone, flip the chart, delete the whole chart. A person added from the menu stands where it was pressed.
  • An empty chart offers to load a tree file, beside the first person.
  • Hovering a person lights their whole line outward, ancestors and descendants. A press on the chart closes open menus.
  • A living person's dates read 1950 –, open at the end, not as a finished life.
  • While a new version is put in place, the page waits and reopens by itself instead of showing an error.

Changed

  • The chart's rows follow birth years, so relatives of one age stand level. Lines keep clear of each other and each branch keeps to one stretch of its row.
  • The family overview, places, checks and search follow the part of the family chosen under Who to show, and say so.

Fixed

  • A GEDCOM event, source or page written over several lines is read whole.
  • A long name on the chart is cut after three lines, so it cannot run into the lines and rows below.
  • A small disk with room to spare is no longer reported as full.
  • Cloud.ru models are read from its own list, with what each can do: tools, pictures and prices in roubles.

v1.3.0

Choose a tag to compare

@github-actions github-actions released this 09 Nov 08:21

The family's records: places, archives and the people at an event, a calendar of family days, a fan of ancestors, private people and stories, a printed page, and a safer sign-out.

Security

  • Signing out empties the browser's cache of photos and removes text never sent and face prints, so the next person at a shared computer finds nothing. It asks first when there is unsent text. Photos are no longer kept for a year without asking the server: a copy left by someone else's session opens only for those allowed to see it.
  • Text kept in the browser while offline is offered back only to the account that typed it.

Added

  • A map of the family's places under Dates, places and archives, and each life's places in order under Life in order. The map comes from OpenStreetMap, so each device allows it once before the first picture is fetched; names and dates never go there.
  • The assistant looks at photos and scans already in the archive, a picture or a PDF, and reads them, handwriting included, then proposes what they show with the document as the source.
  • The assistant and agents add and change places: what a place was part of, its old names and its point on a map, each change waiting for review from a token.
  • The assistant shows a person's ancestors, descendants or close family on the chart when asked.
  • Places as records, under Dates, places and archives: what a place was part of, its old names and when they held, and where it is on a map. Search finds people by an old name too.
  • Archives as records with an address and a site, chosen for each source. A source also keeps its record number, the date of the document and a transcription.
  • People at an event, each with a role: godparent, witness, priest. Those with a card link to it, and readers see no one hidden.
  • Fields of their own for military service (unit, rank), looks, a wound, captivity, an award and a membership. New kinds of fact: estate, title, languages.
  • "No children" and "never married" on a person's family, so the check stops asking.
  • Addresses and phones of living relatives, seen only by editors: never by readers, guests, agents, the file for relatives or GEDCOM.
  • Keep a person who died, or a single story, from readers, guests and read-only agents, as the living are kept. GEDCOM carries the mark both ways.
  • Ask for a story with up to five questions, from a ready list or your own. The relative picks one before each recording, and it names what they send.
  • The server copies the database by itself each day and keeps the last seven. Settings → Data and backups says when it last did, and can copy now.
  • Print a person, or keep them as a PDF: life in order, family, facts, biography, stories and sources.
  • A calendar file of the family's days for a phone or computer, from Dates and numbers.
  • Moving from Gramps and webtrees, checked on files written their way: baptism and other events, the surname from birth, periods of residence, godparents, private marks and the archive a source is kept in now come across. See docs/MOVING.md.
  • Dates and numbers on the chart's toolbar: birthdays and anniversaries of the next two months, and the family in numbers.
  • An ancestor fan for any person: the whole line in one picture, under Who to show.
  • Life in order in a person's details: birth, marriage, children, facts and death, read from what is already written.
  • A page of its own when there is no connection, and a page for a link that leads nowhere, in place of the browser's own.

Changed

  • On a phone, settings open as a list, one section at a time; the bottom bar no longer runs its labels together.
  • A person's card: details come first, the bin and the history moved to a menu, and an empty field no longer offers a source.
  • Clearer words in the settings: no MCP or "smart functions" in the names, the full copy comes first, and a failed action says so and stays until read.
  • The first screen loads less: search and adding a relative come when first used.

Fixed

  • One fact changed on two devices at once: the second is now told, as for a single field, instead of one edit silently replacing the other. A fact one device changed is no longer removed by the other.

v1.2.0

Choose a tag to compare

@github-actions github-actions released this 09 Nov 08:06

Install on any computer without Docker, talk to the assistant, find familiar faces across all photos, and ask a relative for a story by a link.

Security

  • A restored copy can no longer point a file name outside the media folder.
  • Readers no longer see the names of deleted people in the history.
  • The assistant always asks before marking anyone as dead, since that shows them to readers.
  • A sign-in on this computer refuses what arrived through a tunnel or proxy.

Added

  • --server installs on any Linux server in one command, with no Docker and no domain: HTTPS by itself, a service that starts with the server, and nothing reachable from the internet running as root.
  • An installer for Windows, install.ps1, checked when a release is built. Not proven yet: Docker remains the sure way there.
  • ./folkbranch share gives an install on your own computer an address on the internet for a while, so a relative can open a link. It asks first, and ./folkbranch share stop closes it.
  • npx folkbranch installs the app on the first run and opens it after that.
  • Ask a relative for a story by a link: they open it on a phone, press one big button and talk, with no account and without seeing the archive. The recording waits for your review.
  • Bring in a research case from the ex-ussr-kinship-research skill: pick its folder under Settings → Files, or an agent uses import_kinship_case. Candidates stay separate cards, unproved relations stay notes off the chart, and every status and source stays with what it describes. Bringing in the same case again only adds what is new to its cards.
  • A plugin for Claude Code: /plugin marketplace add danarkhipov/folkbranch, then /plugin install folkbranch@folkbranch.
  • ./folkbranch open opens the app in the browser, signed in, and starts it if it was stopped. The first install without Docker opens the browser by itself.
  • A file for relatives: one button under Settings → Users and access makes a single HTML file with the chart, cards and photos. It opens with no server, account or internet, and the living stay hidden.
  • Smart features, switched on separately on each device under Settings → Smart features, and off by default apart from finding faces: suggesting who is in a photo from faces already tagged, and turning a recorded story into text in the browser. Photos and voice stay on the device; only the models are downloaded.
  • Under Check → Faces: look through all photos for familiar faces, and set portraits for people who have none.
  • Speak to the assistant instead of typing, with the words recognised on the device.
  • Models download only when you press the button, in the settings or where a feature needs them, and can be removed again.
  • Choose between models under Settings → Smart features: light, accurate or maximum for finding faces, and GigaAM or Whisper for speech.
  • Faces are found with YuNet and compared with SFace, which handle old group photos far better than the earlier models. Finding and comparing runs away from the page.
  • Install without Docker, on macOS and Linux. One command picks the lightest way: 23 MB if the computer has Node 24, about 48 MB with Node inside the folder. --docker and --domain still use Docker.
  • ./folkbranch start, stop, restart, status and logs for an install without Docker. It restarts itself after a crash and a restore.
  • Hide all the panels: the bar narrows to a square around its logo, with its edge showing behind.
  • The chart works from the keyboard: arrows through the family, + − 0 to zoom, a skip link, the list of keys under How to read the chart, and focus that returns when a panel closes. Screen readers hear the relation on each card.
  • A History tab in each person's card: who changed what and when, what it was before, and a button to roll it back. The card says so when someone else changed it lately.
  • Search looks through everything written about a person: dates in any form, places, facts, sources, biographies, stories and photo captions. It takes other word forms, nicknames, Latin letters, the wrong keyboard, typos and questions like "Ivan's wife", shows what it found in the results, and marks it in the card.

Changed

  • Settings are grouped and each screen says what it is for. View links have their own screen, the first screen links to the others instead of repeating their forms.
  • One kit for the whole interface in components/ui: a styled dropdown instead of the browser's, one text field, copy buttons, switches. A test stops new copies.
  • Every button with a title shows a designed hint, and the main ones say what they do.
  • The history says who changed what, with the old and new value, and has a visible Roll back button on each entry.
  • Review is its own panel: edits to approve, cards to fill in and similar people. The history shows only history.
  • The AI assistant comes first in the top bar, with a clearer icon.
  • Who to show on the chart: choose the person right in the menu, with one line on what each choice means.
  • A key's name is no longer cut to one letter. Revoking a key asks first, and a new key lasts a year unless you choose otherwise.

Removed

  • The Relationship panel in the top bar.

Fixed

  • The install command run through curl | sh stopped before printing the setup link.

v1.1.0

Choose a tag to compare

@github-actions github-actions released this 06 Nov 19:45

Added

  • A logo in the app, a favicon, icons for phones and for installing the app, and a web app manifest.
  • Language by browser on the first screen, with a choice there and under Settings → Archive.
  • An English demo family, so a new English archive starts with English names and text.
  • Tests that catch any interface word without an English translation.

Changed

  • Folkbranch is the project's name. The repository, image, install folder, agent name, key variable (FOLKBRANCH_TOKEN) and command (./folkbranch) all use it.
  • English is the main language, of the interface and of the documentation.
  • New tokens start with fb_. Tokens already issued keep working.
  • Clearer wording across the English interface.
  • Container actions and pinned workflows are up to date. Node stays on its long-term release.

Fixed

  • The top bar folds up in a narrow window when no card is open, instead of running off the edge.
  • The button that revokes an agent's token now says Revoke, not Undo.
  • On a read-only card, a label stays beside its value when the next cell is empty.
  • The assistant shows the server's own words in English too, such as when its daily limit is used up.

v1.0.0

Choose a tag to compare

@github-actions github-actions released this 05 Nov 18:04

First public release.

Added

  • A first-run guide that says what is set up and what is missing, with logos of the services it connects to.
  • Install in one command from a ready image, and one command to connect Claude Code or Codex over MCP.
  • A skill any agent can follow to install the app on a computer or a server.

v0.9.0

Choose a tag to compare

@danarkhipov danarkhipov released this 06 Nov 19:34

Added

  • Merge two cards of one person: every value survives as a version, and one undo restores both.
  • A copy of the database before every migration.

Fixed

  • The person's card holds up under long names, huge families and no data at all.

v0.8.0

Choose a tag to compare

@danarkhipov danarkhipov released this 06 Nov 19:34

Added

  • Stories with a voice, recorded in the browser or from a file, kept apart from facts.
  • Readers can suggest corrections for review.
  • A link that lets anyone view the family without an account.