Skip to content

v0.26.0

Latest

Choose a tag to compare

@github-actions github-actions released this 17 Nov 17:26
· 20 commits to main since this release
3c381ed

GAIA v0.26.0 Release Notes

Summary

  • A new chat answers sooner, and follow-up turns stay cached.
  • GAIA reads and sends Gmail, manages Google and Outlook calendars, analyzes long recordings and video links, and answers Discord messages.
  • A model server that is down or restarting is reported in one plain sentence, and open chats keep working after a restart.
  • Chats no longer leave MCP server processes behind, and credential files stay closed to scripts.
  • The terminal UI is now gaia-cli; see Breaking Changes.
  • 23 contributors merged 812 PRs and closed 726 issues since v0.25.4.

Breaking Changes

  • The terminal UI is now gaia-cli, and gaia-cli no longer means the Python command — its old name was gaia-tui. Updating installs gaia-cli; the one-line installer keeps gaia-tui working, and the Windows setup and macOS and Linux packages remove it. A script that ran the Python CLI as gaia-cli should call gaia. (PRs #7492, #8367)
  • Dynamic tool loading is on by default, and its old settings are gone — GAIA_DYNAMIC_TOOLS_TAU and GAIA_DYNAMIC_TOOLS_MAX do nothing, and a choice made under the old Beta toggle is not carried over. Turn it off with gaia config set dynamic_tools false. (PR #6449)
  • The use_chatgpt and use_openai arguments are gone — delete them and pick the model through Lemonade. (Issue #7023)
  • The gaia-agent-chat package is gone — import ChatAgent with from gaia_agent.chat_agent import ChatAgent, ChatAgentConfig; ChatAgentLite is removed, so use gaia chat. Old sessions still reopen on GAIA. (Issue #6103)

What's New

  • Faster first replies — chat starts on the most-used tools and loads the rest once, and follow-up turns stay cached. (PRs #6449, #5039, #7150)
  • Gmail and calendar from the flagship — draft, reply, forward and send Gmail with approval, plus Google and Outlook calendar tools. (PRs #6479, #6485, #7164)
  • Analyze long recordings and video links — a timestamped, speaker-labelled transcript, report and subtitles, from the CLI or the Agent UI. (PR #6451)
  • Message GAIA from Discord — DM your own bot, and set reminders, alerts and triggers it runs on its own. (PRs #6786, #7144, #6887, #6886)
  • Hear replies read aloud — a speaker button on every Agent UI reply. (PR #6489)
  • See what is happening — a live CPU, memory, GPU, NPU and network strip in every chat, cloud spend in the composer, and every log in the Agent UI. (PRs #6548, #6775, #6664)
  • Edit a sent message, try an answer again, continue a stopped one, and reopen past sessions in the TUI. (PRs #7459, #7465, #7165)
  • Skills — add one by pasting a link, get suggestions for unloaded skills, and use three new ones: report-from-sources, log-triage and meeting-actions. (PRs #5803, #5423, #5421)
  • Models — a hybrid choice sends each turn to a cheaper or a stronger model, and Muse Glimmer 30B is an opt-in local model. (PRs #8196, #7168)
  • Documents in more languages — Arabic, Japanese, Chinese and Cyrillic files read correctly, and a damaged UTF-8 file is refused instead of garbled. (PRs #8024, #8230, #8296)
  • Safer by default — project guidance loads only after asking once per folder, and Undo puts back files a script moved. (PRs #6965, #8128)

Upgrade with:

pip install --upgrade amd-gaia

Bug Fixes

A reference list, most user-visible first. Every merged change is in the changelog below.

Model server and chats

  • Open chats keep working after the model server restarts — GAIA keeps its own server's key across a restart. (PRs #8366, #8162)
  • Deleting a chat stops its MCP servers, and never starts or restarts the agent. (PRs #8364, #8380)
  • MCP server processes are no longer left behind on every new chat. (PR #8298)
  • A failed MCP server no longer shows "Connected", and a missing Node.js or uv is named instead of a transport error. (PRs #8273, #8365, #8163)
  • A document taken off a chat is no longer read — its access is revoked and searches skip it. (PRs #8375, #8025, #8160)
  • A model server that isn't answering gets one plain wording everywhere, appears without a reload, and is translated. (PRs #7576, #7789, #8259, #8235, #7833)
  • A document added at launch waits for GAIA's model server. (PR #8304)
  • A failed turn names the cause and offers Settings, not a command; long errors are cut at a word. (PRs #7729, #8276)
  • An agent crash offers the agent's log, not the model server's. (PR #8359)
  • A sidecar shuts down when its daemon is killed, and the daemon restarts if left on another model server. (PRs #8306, #8075)
  • An unreachable custom Lemonade URL is named, not called "not installed". (PRs #8122, #8066)
  • A cloud turn that failed before any reply is not billed. (PR #8321)
  • A model switch loads the model and carries the chat over. (PR #7590)
  • The TUI says when GAIA stopped mid-answer. (PR #8309)

Safety and privacy

  • A hard link to a credential file is treated as that file in shell searches. (PR #8330)
  • Credential folders are closed to scripts and linked files, recursive searches skip credential files, and credentials are masked in file text and tool output. (PRs #8136, #8220, #8191, #8119)
  • The masked-secret write guard is re-checked after approval. (PR #8260)
  • Links and Python file access stay inside allowed folders. (PR #8204)
  • One folder grant covers writing, editing and renaming there. (PR #7495)
  • A timed-out approval is not re-asked, and an unattended refusal is not taken as the user's "no". (PRs #8076, #8193, #8145)
  • Unattended refusals lead with the safe fallback. (PR #8253)
  • Text handed over to translate is treated as text, not as instructions or a path to browse, so it no longer asks to run a command. (PRs #8233, #8266, #8168)
  • Look-alike Unicode letters are read as their plain forms in checks for planted instructions and fence markers. (PRs #8274, #8275, #8215, #6837)
  • Made-up command output is caught for more ways of asking. (PR #8271)
  • A private chat changes nothing stored in memory. (PRs #8069, #8174)
  • Sign-in codes stay out of logs. (PR #8149)
  • A shell command that reaches a local address is called out. (PR #8156)
  • Shell guardrails survive wrappers, multi-line commands and gh issue close. (PRs #6964, #8065, #6877)

Documents and files

  • Every document in a search gets its best passage. (PR #8074)
  • Legacy-encoded Arabic, Japanese, Chinese and Cyrillic text files read correctly, short ones in this PC's code page. (PRs #8012, #8230, #8307)
  • Chinese, Japanese and Arabic text is searched, chunked and summarized, and Arabic PDF numbers read in order. (PRs #8024, #8053, #8070)
  • A damaged UTF-8 file is refused instead of garbled, and Python scripts write UTF-8. (PRs #8296, #8104)
  • A short file already read whole skips the extra extraction pass. (PR #8241)
  • A saved web page is indexed as its text, and PDFs with large arrays read. (PRs #8179, #8181)
  • After a one-file miss, every attached document is searched, and a document is re-searched before "not in it". (PRs #8153, #8106)
  • A document's text is treated as data when summarizing. (PR #8132)
  • PDF table rows stay whole. (PR #8116)
  • An edited document is re-indexed and no longer served stale. (PRs #6906, #6947, #6917)
  • Parallel uploads no longer break each other's embedding. (PR #8049)
  • Attachments are cited by their own name, and previews stop showing raw bytes. (PRs #6896, #7753)
  • Undo puts back files a Python snippet moved or renamed. (PR #8128)
  • A damaged .pptx is reported as damaged, and a too-large file as over the limit. (PRs #7906, #7904)
  • Images left unread while the vision model was down are read later, and a broken vision model is named. (PRs #7133, #7154)

Agent answers

  • Mail tools load for mail questions. (PR #8222)
  • A skill suggestion is offered instead of an order to load. (PR #8229)
  • Fewer wasted steps, stalls and empty answers in the agent loop. (PR #8211)
  • Long plan-driven turns run to their step budget, and the default step limit is 1000. (PRs #8110, #7325)
  • An answer that reports a failure gets no "not confirmed" note, and more ways of claiming a save are checked. (PRs #7735, #7539, #7579, #7540)
  • An answer that claims all files were read says how many were. (PR #8109)
  • A turn stopped at a limit ends with the work done and a way on. (PRs #8112, #6296)
  • A reply that turns into repeated noise is stopped, and native tool-call JSON stays out of the answer. (PRs #8173, #7248)
  • A thinking model's reasoning stays out of gaia prompt output, which prints the answer once. (PRs #8141, #8135, #7238)
  • Edits to a file owned by another process are stopped, and an edit sent twice is refused. (PRs #6434, #6844)
  • Relative outputs are found in the folder the request named. (PR #8103)
  • Scratch folders no longer pile up in the temp folder. (PR #8108)
  • Overflows from cloud and Claude models trigger trim-and-retry. (PR #7758)
  • A memory GAIA is asked to keep is saved, a forget goes through after "never mind", and every copy of a forgotten memory goes. (PRs #7148, #6920, #6858)

Goals, schedules and automations

  • A failing recurring schedule is recorded on the schedule itself. (PR #8320)
  • A goal is marked stalled after 10 check-backs, its retry count resets when queued again, and one that can't be done stops retrying. (PRs #8223, #8198, #8081)
  • Deleting a schedule asks in a dialog, and a deleted or paused schedule closes its run's chat. (PRs #8237, #8157)
  • gaia schedule run uses the app's model and never downloads one. (PR #8113)
  • A finished schedule notifies you, and failures from while the app was closed are announced. (PRs #7696, #7648)
  • gaia schedule says an unknown name is unknown, and add prints one line when it reuses a name. (PRs #7534, #8126)
  • Schedules whose name contains a slash can be managed. (PR #6954)
  • Scheduled sends that fail are reported to the user. (PR #6979)

CLI

  • gaia chat and -p send every request to --base-url, as do talk indexing and API health. (PRs #8256, #7236)
  • gaia download and gaia api start fail when the server is unreachable. (PRs #6872, #7237, #7346)
  • gaia cache status shows every cache folder and its size and no longer follows Windows junctions. (PRs #7132, #7239)
  • gaia kill --lemonade stops the Lemonade Server GAIA uses. (PR #6991)
  • gaia prompt --device selects the matching model. (PR #6894)
  • gaia connectors connect names the connectors it can use, and unhandled commands exit 1. (PRs #7535, #7051)
  • A search service error is one line, not a traceback. (PRs #8310, #8311, #8315)
  • A relayed gaia -p reports steps, tool calls and tokens. (PR #7234)

Agent UI and TUI

  • A taken schedule name shows on the Name field, and the New schedule draft survives closing the dialog. (PRs #7675, #7798)
  • Chat search shows plain words and stays fast on huge messages. (PRs #7772, #8206)
  • One size for a model and one free-space figure everywhere. (PR #8231)
  • "Memory on" is a small menu, and Remove on a document can be undone. (PRs #7498, #7512)
  • Setup offers this PC and a cloud model as two equal choices, and keeps the cloud model in use when run again. (PRs #7470, #7778)
  • One Connect card shows when several mail steps need an account. (PR #8352)
  • The spend in the composer shows this chat and today to the same decimals, and leaves failed turns out. (PRs #8351, #7581)
  • A Mac update chip links to the release instead of installing. (PR #7832)
  • The side panel, home and Settings get more room. (PR #8277)
  • Arabic layout fixes across answer tables, the file browser, documents, setup and the network rate. (PRs #8238, #7898, #7666, #7821, #8372)
  • The TUI resolves bare file names in its start folder and sends it so the project map finds the project. (PRs #7246, #7766)
  • The TUI names GAIA's chat model in the status line on a shared Lemonade. (PR #8224)
  • The robot head shows on notifications. (PR #8341)

Install, Linux and desktop

  • A running exe under either name no longer breaks the one-line installer, and the old name is refused when going back. (PR #8367)
  • A stock GNOME desktop keeps GAIA running without a tray extension. (PR #6868)
  • The AppImage gets a launcher, and GAIA shows once in the app grid and opens on Wayland. (PRs #7078, #7149)
  • A missing system library or CA file is named instead of dying silently. (PRs #7157, #7255)
  • An agent left running for days on macOS keeps answering. (PR #6851)
  • A low-disk update no longer marks the install failed. (PR #6916)
  • A crashed window offers a reload instead of quitting GAIA, and a clean renderer exit is not a crash. (PRs #7301, #7155)
  • Each process stops reserving 5 GB of OpenBLAS threads. (PR #7324)
  • A second launch skips the install screen for a new user. (PR #7994)
  • The macOS menu bar draws the GAIA logo. (PR #6989)
  • Docs for another computer's Lemonade, setup steps, memory categories, privacy claims and eval examples. (PRs #6865, #6852, #6864, #7544, #6863)

Email, connectors and tools

  • Outlook search queries Graph rejects are no longer taught. (PR #8123)
  • Connectors Test starts an MCP server and says if it started. (PR #6883)
  • Slack setup is one click, and Slack and gateway auth say they need a terminal. (PRs #6855, #7537)
  • A cancelled sign-in is called cancelled, with an offer to retry. (PR #7840)
  • search_web keeps working through a long research turn, and redirect rate waits no longer time out a fetch. (PRs #7859, #6857)
  • Invented figures are caught when written like 2,708.95 USD, and averages worked by hand after a failed run are checked. (PRs #6817, #6831)

Known Issues

  • NPU PCs: chat on the NPU profile returns an empty reply, and the embedder falls back to GGUF — use the GPU/CPU profile for now. Tracked in #6008.
  • Fedora 44: setup cannot reach any HTTPS site, so it can neither connect a cloud model nor download one — tracked in #7226.
  • Long sessions on Windows: Lemonade's bundled llama-server leaks handles on every request until the model server restarts — restart it from time to time. An upstream Lemonade issue, tracked in #8312.
  • Coding: editing a requested config or data file, or a skill's SKILL.md, does not mark an earlier "tests pass" as stale — re-run the tests after such an edit. Tracked in #8213.
  • Your own model server, stopped: the connection banner says it is "not installed" and suggests gaia init — start your server again. Tracked in #8313.
  • Summarizing a 1,000+ page document can time out — ask about sections or page ranges instead. Tracked in #8218.
  • Attached files lose the spaces in their names, so team meeting notes.wav becomes team_meeting_notes.wav — rename the file before attaching if the name matters. Tracked in #8361.

Contributors

Thanks to the community members who contributed to this release:

Full Changelog

812 commits since v0.25.4. The PR links above are the changelog.

Full Changelog: v0.25.4...v0.26.0


Installation

Desktop installer (recommended for end users)

Download the installer for your platform from the assets below:

  • Windows — the GAIA installer from https://amd-gaia.ai/#install (gaia-*-win-x64-setup.exe): choose the desktop app, the terminal, or both. gaia-agent-ui-*-x64-setup.exe below is the desktop app on its own (autostart on by default)
  • macOS — gaia-agent-ui-*-arm64.dmg (drag to Applications, Apple Silicon only)
  • Linux — gaia-agent-ui-*-amd64.deb (Debian/Ubuntu) or gaia-agent-ui-*-x86_64.AppImage (any distro)

On first launch the app sets up its Python backend automatically (~5–10 minutes for the minimal profile, depends on your internet speed).

See the installation guide for setup details and troubleshooting.

Developer install (Python CLI)

Install GAIA using pip:

pip install amd-gaia

Or using uv:

uv pip install amd-gaia

Or via npm:

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