Repository navigation
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, andgaia-clino longer means the Python command — its old name wasgaia-tui. Updating installsgaia-cli; the one-line installer keepsgaia-tuiworking, and the Windows setup and macOS and Linux packages remove it. A script that ran the Python CLI asgaia-clishould callgaia. (PRs #7492, #8367) - Dynamic tool loading is on by default, and its old settings are gone —
GAIA_DYNAMIC_TOOLS_TAUandGAIA_DYNAMIC_TOOLS_MAXdo nothing, and a choice made under the old Beta toggle is not carried over. Turn it off withgaia config set dynamic_tools false. (PR #6449) - The
use_chatgptanduse_openaiarguments are gone — delete them and pick the model through Lemonade. (Issue #7023) - The
gaia-agent-chatpackage is gone — importChatAgentwithfrom gaia_agent.chat_agent import ChatAgent, ChatAgentConfig;ChatAgentLiteis removed, so usegaia 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
hybridchoice 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-gaiaBug 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 promptoutput, 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 runuses 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 schedulesays an unknown name is unknown, andaddprints 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 chatand-psend every request to--base-url, as do talk indexing and API health. (PRs #8256, #7236)gaia downloadandgaia api startfail when the server is unreachable. (PRs #6872, #7237, #7346)gaia cache statusshows every cache folder and its size and no longer follows Windows junctions. (PRs #7132, #7239)gaia kill --lemonadestops the Lemonade Server GAIA uses. (PR #6991)gaia prompt --deviceselects the matching model. (PR #6894)gaia connectors connectnames 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 -preports 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_webkeeps 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.wavbecomesteam_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:
- @tylerbea — Gmail and calendar tools, interactive cards, image thumbnails, Slack setup, and over a hundred Agent UI fixes including Arabic translation and layout (PRs #6479, #6485, #6086, #7697, #6855, #6851)
- @huong8373tt-beep — per-agent tool scopes, word-stem skill search, TUI media outputs, agent safety checks, email, memory and RAG fixes (PRs #6558, #6523, #6254, #6821, #6964, #6985)
- @ityashag — goal stalling, failing-schedule records, document search and vision-indexing fixes, CLI cache and kill fixes, and docs (PRs #8223, #8320, #7131, #7133, #7132, #6991)
- @bniladridas — NPU model checks in the TUI, unattended refusals, mail tool loading, setup-problem wording, and goal retry counts (PRs #7122, #8253, #8222, #8210, #8198, #6875)
- @rezamuliawijaya — eval corpus checks,
gaia downloadandgaia prompt --devicefixes, document re-index and forget fixes (PRs #6869, #6872, #6894, #6917, #6920) - @lakshyab20 — CLI errors that print a message instead of a traceback (PRs #7534, #7535, #7536, #7537)
- @KrBeTect2025 —
--base-urlforgaia chat, quietgaia promptoutput, andgaia schedule addon a reused name (PRs #8256, #8141, #8126, #8257) - @Drchennnn — voice startup indexing, live-catalog model status, and release tests (PRs #6638, #7123, #7152)
- @akshat-lakhera — the once-per-folder project guidance prompt (PRs #6965, #6987)
- @iam-hk — skill suggestions, the masked-secret write guard, and accented-letter reading (PRs #8229, #8260, #8274)
- @wasiulhaque — email docs and API contract checks (PRs #6879, #6910, #6913)
- @tharunsridhar — refusing to index an unreadable document, and docs (PRs #6978, #6933, #7001)
- @swastiktawate — CI references, file-io tests and email doc links (PRs #6922, #6960, #6961)
- @burgulvedant — a cloud model that needs reconnecting, and guide fixes (PRs #8209, #6900, #6931)
- @DevShoaib78 — hub agent docs (PRs #6940, #6941)
- @saruk-vedant — refusing a router model as the Custom model ID (PR #7548)
- @txltedxgod — tools used on unprinted turns (PR #7265)
- @recentbontipiece — the macOS menu bar logo (PR #6989)
- @kratos0718 — privacy wording (PR #7544)
- @georgekhananaev — the
--save-baselinewarning (PR #6981) - @SanketJadhav7d3 — privacy wording for cloud sessions (PR #6888)
- @cf3901646 — a midnight-UTC test fix (PR #7114)
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.exebelow 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) orgaia-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-gaiaOr using uv:
uv pip install amd-gaiaOr via npm:
npm install -g @amd-gaia/agent-ui