Skip to content

v0.25.4-rc3

Pre-release
Pre-release

Choose a tag to compare

View all tags
@github-actions github-actions released this 01 Nov 22:04
· 779 commits to main since this release
v0.25.4-rc3
9a525c7
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Important

Release candidate for v0.25.4. A pre-release for testing before the final ships. Installers and package managers keep offering the last final release unless you ask for this one.

GAIA v0.25.4 Release Notes

What's New

  • Use the Agent UI in Arabic, and ask about Arabic, English or mixed documents in either language — the interface runs fully right to left, answers follow the language of the question, and citations open the document at the cited page. Arabic PDFs keep their numbers and Latin terms when indexed. (PR #6165)
  • Keep every AI request on this PC — gaia config set network_policy local_ai_only refuses any request to a cloud model before it is sent, across chat, agents, documents, speech, the Agent UI, the terminal UI and web search. (PR #5956)
  • Index screenshots, receipts and scanned pages — PNG, JPG, WebP, BMP, GIF and TIFF files are read with the vision model when you pick or drop them. (PR #5651)
  • The GAIA agent reads whole email threads and finds mail waiting on your reply, in Gmail and Outlook, still read-only. (PR #6124)
  • Add to this reply and Always allow work with the GAIA agent — a message sent mid-answer reaches the running turn, and "Always allow" grants are listed and revocable per chat and in Settings. (PR #5541)
  • Start new chats in full access from Settings › Permissions, after confirming a warning. (PR #5827)
  • Skills can carry their own tools into the release build, gated like the core tools they resemble. (PRs #5450, #5454)
  • The Agent UI no longer adds an "Example Agent" to every agent list; unedited copies are removed. (PR #6123)

Bug Fixes

  • A chat you start is no longer stuck on "Waiting for the GPU" behind a background task GAIA proposed for itself. (PR #6096)
  • "Save it to my Documents folder" writes to your Documents folder, not GAIA's hidden one, and shell, code search, watched folders and saved audio, screenshot and download paths use the chat's folder. (PRs #6074, #6069)
  • Adding a document again after moving it updates its location, instead of leaving chats pointing at the old, missing file. (PR #6177)
  • One chat indexing large documents no longer blocks other chats from starting. (PR #6171)
  • A repo picked with index_codebase is remembered on the next turn. (PR #6056)
  • A context window you set deliberately small is kept, and a GPU that reports an implausible amount of VRAM no longer picks an unsafe one. (PRs #6152, #6150)
  • Chats get a topic title while their first answer runs on a cloud model, and a failed title is retried on later turns. (PRs #5972, #6174)
  • Two Agent UI processes starting together no longer race on a chat-database upgrade, the email and chat databases retry their setup, and a locked database waits its timeout once and names the file. (PRs #6151, #6044, #6054)
  • Undo is offered after a turn that changed files and then errored, and a reply that only ran read-only commands like ls no longer warns that Undo can't restore files. (PRs #6083, #6120)
  • The terminal UI says when it is older than the installed GAIA, with a download link. (PR #6141)
  • gaia-desktop runs from a terminal after installing the .deb. (PR #6131)
  • Outlook unread listings work. (PR #6119)
  • "Remind me tomorrow" no longer promises an alert GAIA can't deliver, and a memory setting that fails to save says so instead of reporting success. (PRs #6127, #6081)
  • Data questions about a workbook read every sheet, not just the first, so a balance sheet on sheet two is found. (PR #6130)
  • gaia -p "" fails straight away with a clear message instead of hanging when the prompt variable is empty. (PR #6168)
  • Document summaries follow the style you asked for, and the data profile no longer offers web and media tools it doesn't have. (PRs #6057, #6053)
  • The flagship agent wheel ships its starter skills. (PR #6080)
  • Importing gaia no longer reconfigures the host program's logging. (PR #5951)
  • Ctrl+D or Ctrl+C at the agent import prompt answers "no" instead of crashing. (PR #6140)
  • Docs — fixed broken amd-gaia.ai links, replaced the retired --bypass-permissions with --full-access, and corrected the guides index, custom-agent, skills, eval and /query contract pages. (PRs #6066, #6129, #6147, #6146, #6145, #6133, #6134, #6135, #6137, #6113)

Known Issues

  • Attaching an image on a PC that uses only AMD LLM Gateway models starts a ~5 GB vision-model download inside the turn. Run gaia download --agent vlm first so the download happens up front. Tracked in #5990.
  • A relayed GAIA turn can lose its final answer after you approve a prompt, about one time in ten. It says the step didn't run; send the message again. Tracked in #6019.

Contributors

Thanks to the community members who contributed to this release:

Full Changelog

59 commits since v0.25.3:

  • f699d20fa — ci(release): build the macOS arm64 sidecars on macos-15 (#6182)
  • 2f14be235 — fix(ui): stop one chat's indexing from blocking other chats (#6171)
  • 19a18ad42 — fix(ui): follow a moved document when it is added again (#6177)
  • 4479732b8 — fix(release): redeploy the website when a final release publishes (#6162)
  • 156c21ba6 — fix(tools): let analyze_data_file read every sheet of a workbook (#6130)
  • 5fb8835b2 — fix(cli): refuse an empty gaia -p prompt instead of hanging (#6168)
  • 2a5a2b177 — feat(ui,rag): Arabic interface and bilingual document Q&A (#6165)
  • dbcd55a44 — fix(ui): do not warn Undo after read-only shell commands (#6120)
  • 4eb6aab9d — ci(unit): guard recurring bug shapes and run only the tests a PR can reach (#5653)
  • fc5001857 — fix(ui): wait for a cancelled chat title to stop before the turn runs (#6174)
  • 4ace42416 — fix(hub): ship starter skills in flagship wheel (#6080)
  • 20abdc4c5 — ci: workflow alert issues dedupe and close themselves; add issue-filing rules (#5408)
  • bd438272d — fix(logger): make log configuration explicit, remove import side effect (#5951)
  • 063ff26c6 — ci(audits): one proactive audit a night, with quota gate and carry-over (#5404)
  • c980ccede — ci(eval): score Gemma on Strix Point, refuse cross-model compares (#5511)
  • b357bd95e — chore(eval): remove 34 unused prompt files from eval/prompts (#6128)
  • 1b28f5ff3 — feat(skills): skill context API for paths, programs, temp files and preferences (#5454)
  • 203724815 — feat(agent-ui): default full-access toggle in Settings > Permissions (#5827)
  • 83ad57e6f — refactor(agents): fold ChatAgent into the flagship package (#6139)
  • ef1f9766f — fix(ui): reject implausible VRAM reports (#6150)
  • 4462f602a — fix(ui): serialize chat database schema upgrades (#6151)
  • df9b9e0e7 — docs(plans): release eval hardening — stress and adversarial gaps (#5493)
  • 414a2aa05 — docs(guides): card every guide the User Guides nav lists on the index page (#6147)
  • 3ba0956ad — docs(custom-agent): snapshot each agent's tools after registering them (#6146)
  • fb05a2c39 — docs: name /full-access confirm and the environment tags for --exclude-tag (#6145)
  • 642e61413 — fix(agent): respect deliberately small context windows (#6152)
  • 46531e586 — feat(skills): ship bundled skill code in the binary and gate it like core tools (#5450)
  • 9544088a3 — docs(gaia): move post-0.3.3 changelog entries back to Unreleased (#6158)
  • d9c56574d — feat(ui): Add to this reply and Always allow work with the flagship agent (#5541)
  • 15d0e463a — feat(rag): index images by reading their text with the vision model (#5651)
  • 630b7374e — fix(ui): retry chat titles and name a chat while its first answer runs (#5972)
  • c8805ce92 — feat(llm): Local only — no GAIA AI request reaches a cloud model (#5956)
  • 8afe6d06f — fix(code-index): retain selected repo across turns (#6056)
  • 93128f7a9 — fix(storage): retry WAL setup for remaining databases (#6044)
  • d01897c2d — fix(agent): resolve the user's Documents folder (#6074)
  • d6c399836 — fix(memory): avoid promising undelivered reminder alerts (#6127)
  • 6ac3cc1a6 — fix(memory): report settings persistence failures (#6081)
  • 9ee540d5c — fix(agent): resolve remaining tool paths in chat workspace (#6069)
  • c7077aba1 — fix(storage): stop a locked database making GAIA wait 3x its timeout (#6054)
  • 65ebf7b54 — test(email): drop the prompt assertions against the retired email agent (#6132)
  • 8c16e5b0b — fix(ui): make timestamp-tied chat ordering deterministic (#6087)
  • 2c1655e78 — fix(tui): notify when the terminal UI is outdated (#6141)
  • 7cf4d93f0 — fix(installer): restore gaia-desktop command on Debian (#6131)
  • 9e7ec94d3 — fix(ui): let foreground chats preempt background goal runs (#6096)
  • 7f8eea186 — fix(email): make Outlook unread filters sortable (#6119)
  • e040fb798 — test(slack): wait for bridge child to finish exec (#6097)
  • 67293725b — fix(ui): keep Undo available after error turns (#6083)
  • 8fa713b17 — fix(rag): align document summary styles with skill contract (#6057)
  • 737d581be — fix(chat): advertise web and media tools only in profiles that register them (#6053)
  • c3f66e28e — feat(email): flagship reads threads and finds mail waiting on you (#6124)
  • ddfe80aeb — refactor(agents): keep one reference agent package, remove the rest (#6123)
  • d4ffc5c77 — fix(cli): treat Ctrl+D/Ctrl+C at the agent import prompt as "no" (#6140)
  • d22ec1143 — docs(eval-ci): drop the --backend cloud-provider tip (#6137)
  • a7bff67b9 — docs(eval): use tags the shipped scenarios carry in the tag-filter example (#6135)
  • d348724c0 — docs(gaia): quote the real Access denied message (#6134)
  • 16b3029e6 — docs(skills): create ~/my-skills before forking a starter skill (#6133)
  • 857996a23 — docs: replace the retired --bypass-permissions and /bypass with --full-access (#6129)
  • f4c63c46e — docs(spec): cover query fields through contract 2.25 (#6113)
  • 7d13eac07 — fix(docs): add /docs/ prefix to broken amd-gaia.ai links (#6066)

Full Changelog: v0.25.3...v0.25.4

Installing this release candidate

Desktop app and terminal

Download the installer for your platform from the assets below:

  • Windows — gaia-0.25.4-rc.3-win-x64-setup.exe: one installer for the desktop app, the terminal, or both. gaia-agent-ui-0.25.4-rc.3-x64-setup.exe is the desktop app on its own
  • macOS — gaia-agent-ui-0.25.4-rc.3-arm64.dmg (Apple Silicon only)
  • Linux — gaia-agent-ui-0.25.4-rc.3-amd64.deb (Debian/Ubuntu) or gaia-agent-ui-0.25.4-rc.3-x86_64.AppImage (any distro)

The terminal on its own:

  • macOS — gaia-0.25.4-rc.3-darwin-arm64.pkg (Apple Silicon) or gaia-0.25.4-rc.3-darwin-x64.pkg (Intel)
  • Linux — gaia_0.25.4-rc.3_amd64.deb (Debian/Ubuntu) or gaia-0.25.4-rc.3.x86_64.rpm (Fedora/RHEL/SUSE). They install as version 0.25.4~rc.3, so the final release upgrades over them

Installer checksums are in gaia-installers-SHA256SUMS.txt. The terminal hub is also attached as standalone binaries (gaia-<os>-<arch>, checksums in gaia-tui-SHA256SUMS.txt).

The GAIA agent itself is attached as gaia-agent-<os>-<arch>, built from this candidate's commit. This candidate's gaia init and gaia hub install gaia install it from here rather than from the Agent Hub, and say so if it is missing.

One-line installer

Installs this candidate's Python CLI, terminal and GAIA agent together:

curl -fsSL https://amd-gaia.ai/install.sh | GAIA_RELEASE_TAG=v0.25.4-rc3 sh
$env:GAIA_RELEASE_TAG = "v0.25.4-rc3"; irm https://amd-gaia.ai/install.ps1 | iex

Python CLI

pip install --pre amd-gaia            # newest pre-release
pip install amd-gaia==0.25.4rc3     # exactly this one

npm

npm install -g @amd-gaia/agent-ui@next

Found a problem? Open an issue and mention v0.25.4-rc3.

Assets 34
Loading