Skip to main content
First time here? Complete the Setup guide first to install GAIA and its dependencies.
The Analyst Agent is a focused structured-data agent for users who want scratchpad table tools without the full Chat Agent tool surface. It’s useful for CSV-style rows, extracted records, and calculations that should be performed by SQL instead of mental arithmetic. Who it’s for: anyone who has rows of data and wants the model to compute over them reliably — totals, group-bys, filters — by writing SQL against an in-memory scratchpad table rather than guessing at numbers.

​
Prerequisites

  • GAIA installed (see Setup).
  • A local model available — run gaia init if you haven’t set one up. By default the agent uses the local Lemonade backend.

​
Quick Start

Run a single analysis task with -q:
Use interactive mode when you want to build up tables and ask follow-up questions:

​
Tool Surface

gaia analyze --list-tools shows the exact tools available in your installed version. The focused Analyst Agent exposes:
  • create_table — create a scratchpad SQL table.
  • insert_data — load structured rows.
  • query_data — run SQL calculations and filtering.
  • list_tables — inspect available tables.
  • drop_table — remove a scratchpad table.
The Analyst Agent does not register browser tools. Use gaia browse for web research, or gaia chat when you need the broader mixed tool set.

​
Model and Backend Options

By default, gaia analyze uses the local Lemonade backend configured for GAIA. You can override the model or backend with the common agent flags:
Other shared agent flags work here too — --max-steps to bound the run, --trace to save a JSON execution trace, and --stats for performance metrics. In the Agent UI the analyst appears as a single data card with a model-size selector — pick Lite (~4B) for shorter analysis tasks on lighter hardware, or Full for the default model. (The old data-lite registry ID still resolves to data on the lite tier for existing sessions.)

​
Next Steps

Browser Agent

Search the web, fetch pages, and download files.

Document Q&A

The full chat agent with RAG, memory, and the broader tool set.

CLI Reference

Every gaia command and flag.

All Guides

Browse every GAIA agent.