> ## Documentation Index
> Fetch the complete documentation index at: https://amd-gaia.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# User Guides

> Learn how to use GAIA's pre-built agents and SDKs

<Info>
  **Looking to build your own agent?** Check out the [Playbooks](/docs/playbooks) for step-by-step tutorials on building agents from scratch.
</Info>

User guides show you how to **use** GAIA's pre-built agents and SDKs. Each guide covers installation, configuration, and common usage patterns.

<Info>
  **Guides vs Playbooks**

  * **User Guides** (this section): How to *use* pre-built agents — quick start, configuration, CLI commands
  * **[Playbooks](/docs/playbooks)**: How to *build* agents — step-by-step tutorials explaining implementation details
</Info>

***

## Setup & Hardware

<CardGroup cols={2}>
  <Card title="Hardware Advisor" icon="microchip" href="/docs/guides/hardware-advisor">
    Determine what LLMs your system can run based on RAM, GPU, and NPU capabilities.
  </Card>

  <Card title="NPU Acceleration" icon="bolt" href="/docs/guides/npu">
    Run GAIA agents on AMD Ryzen AI NPU for power-efficient local inference.
  </Card>
</CardGroup>

***

## Core Agents

<CardGroup cols={2}>
  <Card title="Document Q&A" icon="message" href="/docs/guides/chat">
    Build conversational AI with text chat, memory, and document Q\&A (RAG).
  </Card>

  <Card title="Voice Interaction" icon="microphone" href="/docs/guides/talk">
    Natural voice conversations using Whisper (ASR) and Kokoro (TTS).
  </Card>

  <Card title="Browser Agent" icon="globe" href="/docs/guides/browse">
    Search the web, fetch pages, and download files with a focused agent.
  </Card>

  <Card title="Analyst Agent" icon="chart-column" href="/docs/guides/analyze">
    Load structured rows into scratchpad tables and query them with SQL.
  </Card>
</CardGroup>

***

## Developer Tools

<CardGroup cols={2}>
  <Card title="Code Agent" icon="code" href="/docs/guides/code">
    AI-powered full-stack Next.js generation with TypeScript, Prisma, and Tailwind.
  </Card>

  <Card title="Code Index" icon="magnifying-glass-code" href="/docs/guides/code-index">
    Semantic search over your codebase using local AMD-accelerated embeddings.
  </Card>

  <Card title="Docker Agent" icon="docker" href="/docs/guides/docker">
    Natural language interface for containerizing applications.
  </Card>
</CardGroup>

***

## Connected Agents

<CardGroup cols={2}>
  <Card title="Email Triage" icon="envelope" href="/docs/guides/email">
    Read, organize, and reply to Gmail with email content processed locally.
  </Card>

  <Card title="Telegram Adapter" icon="paper-plane" href="/docs/guides/telegram-adapter">
    Talk to GAIA from Telegram on any device, with per-user sessions.
  </Card>

  <Card title="Jira Agent" icon="ticket" href="/docs/guides/jira">
    Natural language interface for searching and managing Jira issues.
  </Card>
</CardGroup>

***

## Specialized Agents

<CardGroup cols={2}>
  <Card title="Image Generation" icon="image" href="/docs/guides/sd">
    Multi-modal image generation with LLM prompt enhancement and VLM story creation.
  </Card>

  <Card title="Blender Agent" icon="cube" href="/docs/guides/blender">
    Natural language 3D scene creation and manipulation in Blender.
  </Card>

  <Card title="Medical Intake (EMR)" icon="hospital" href="/docs/guides/emr">
    Automate patient intake form processing with VLM extraction and local database storage.
  </Card>

  <Card title="Routing Agent" icon="route" href="/docs/guides/routing">
    Intelligent request analysis and agent selection through conversational disambiguation.
  </Card>
</CardGroup>

***

## Build & Extend

<CardGroup cols={2}>
  <Card title="Custom Agents" icon="wand-magic-sparkles" href="/docs/guides/custom-agent">
    Create your own AI agents and add them to the GAIA Agent UI.
  </Card>

  <Card title="Publishing to the Hub" icon="upload" href="/docs/guides/hub-publishing">
    Build, version, and publish a GAIA agent to the Agent Hub.
  </Card>
</CardGroup>

***

## MCP Integration

<CardGroup cols={2}>
  <Card title="MCP Client" icon="plug" href="/docs/guides/mcp/client">
    Connect your agent to any MCP server - filesystem, GitHub, databases, and hundreds more.
  </Card>

  <Card title="Windows System Health" icon="display" href="/docs/guides/mcp/windows-system-health">
    Monitor Windows system health using MCP-powered diagnostics.
  </Card>
</CardGroup>

***

## Choosing a Guide

| If you want to...                       | Start here                                                 |
| --------------------------------------- | ---------------------------------------------------------- |
| Check what models your hardware can run | [Hardware Advisor](/docs/guides/hardware-advisor)               |
| Build a chatbot or document Q\&A        | [Document Q\&A](/docs/guides/chat)                              |
| Add voice to your agent                 | [Voice Interaction](/docs/guides/talk)                          |
| Research the web from the CLI           | [Browser Agent](/docs/guides/browse)                            |
| Run SQL over structured rows            | [Analyst Agent](/docs/guides/analyze)                           |
| Generate Next.js applications           | [Code Agent](/docs/guides/code)                                 |
| Search your codebase semantically       | [Code Index](/docs/guides/code-index)                           |
| Containerize applications               | [Docker Agent](/docs/guides/docker)                             |
| Triage your Gmail inbox locally         | [Email Triage](/docs/guides/email)                              |
| Chat with GAIA from your phone          | [Telegram Adapter](/docs/guides/telegram-adapter)               |
| Work with Jira tickets                  | [Jira Agent](/docs/guides/jira)                                 |
| Generate images from text               | [Image Generation](/docs/guides/sd)                             |
| Create 3D scenes with AI                | [Blender Agent](/docs/guides/blender)                           |
| Process medical intake forms            | [Medical Intake](/docs/guides/emr)                              |
| Route requests to specialized agents    | [Routing Agent](/docs/guides/routing)                           |
| Build and publish your own agent        | [Custom Agents](/docs/guides/custom-agent)                      |
| Connect agents to external MCP tools    | [MCP Client](/docs/guides/mcp/client)                           |
| Monitor Windows system health           | [Windows System Health](/docs/guides/mcp/windows-system-health) |

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Playbooks" icon="book-open" href="/docs/playbooks">
    Learn to build agents from scratch with step-by-step tutorials
  </Card>

  <Card title="SDK Reference" icon="book" href="/docs/sdk">
    Complete API documentation for all GAIA components
  </Card>

  <Card title="CLI Reference" icon="terminal" href="/docs/reference/cli">
    Command-line tools for chat, voice, RAG, and more
  </Card>

  <Card title="FAQ" icon="circle-question" href="/docs/reference/faq">
    Common questions and troubleshooting
  </Card>
</CardGroup>

***

<small style="color: #666;">
  **License**

  Copyright(C) 2024-2026 Advanced Micro Devices, Inc. All rights reserved.

  SPDX-License-Identifier: MIT
</small>