Run GAIA agents on AMD Ryzen AI NPU for power-efficient local inference
GAIA supports running agents on your AMD Ryzen AI NPU via the FastFlowLM (FLM) backend. NPU inference is power-efficient and frees your GPU for other tasks.
NPU inference works on Linux the same way — run gaia init --profile npu and Lemonade Server installs the FLM backend automatically.If Lemonade detects that your system needs additional setup (for example, the amdxdna kernel driver on older kernels), it will point you to the Lemonade Linux FLM guide with distro-specific steps. Follow them, then re-run gaia init --profile npu.
Download the NPU-optimized models (gemma4-it-e2b-FLM for chat, embed-gemma-300m-FLM for documents and memory)
Install the GAIA agent if it is missing, the same agent a bare gaia init installs
Run a verification test and make NPU the default device
The Agent UI and terminal UI then have an agent to talk to. If GAIA’s download server can’t be
reached, setup still downloads the models, then reports itself incomplete and exits
1 — run gaia init --profile npu again once the network is back. To return to the GPU, run
gaia config set default_device gpu.
Error pulling model: No built-in model with the name 'gemma4-it-e2b-FLM' is registered.
The FLM backend is missing, not the model. Lemonade discovers *-FLM models
through the FLM runtime itself, so until flm:npu is installed none of them
exist to pull. Install the backend first, then pull by name:
Do not add --recipe flm. The recipe is baked into the built-in model and
applied at load time; passing it turns the call into a custom-model
registration, which fails asking for --checkpoint.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"GAIA SDK","colors":{"primary":"#A87B2D","light":"#E2A33E","dark":"#E2A33E"},"logo":{"light":"https://mintcdn.com/amd-fe836e11/PgPhi3UrqFX2lV53/assets/favicon.ico?fit=max\u0026auto=format\u0026n=PgPhi3UrqFX2lV53\u0026q=85\u0026s=77bcf8b2d70613766cc02f16b0e208a0","dark":"https://mintcdn.com/amd-fe836e11/PgPhi3UrqFX2lV53/assets/favicon.ico?fit=max\u0026auto=format\u0026n=PgPhi3UrqFX2lV53\u0026q=85\u0026s=77bcf8b2d70613766cc02f16b0e208a0","href":"https://github.com/amd/gaia"},"favicon":"https://mintcdn.com/amd-fe836e11/PgPhi3UrqFX2lV53/assets/favicon.ico?fit=max\u0026auto=format\u0026n=PgPhi3UrqFX2lV53\u0026q=85\u0026s=77bcf8b2d70613766cc02f16b0e208a0","appearance":{"default":"system"},"navbar":{"links":[{"href":"https://github.com/amd/gaia/releases","label":"v0.25.1 · Lemonade 2026.43.3"},{"href":"https://amd-gaia.ai","label":"Main Site"}],"primary":{"type":"button","label":"Download","href":"https://amd-gaia.ai/#install"}},"footer":{"socials":{"github":"https://github.com/amd/gaia","discord":"https://discord.com/invite/5xXzkMu8Zk","twitter":"https://twitter.com/amd","linkedin":"https://linkedin.com/company/amd"}},"fonts":{"heading":{"family":"Inter"},"body":{"family":"Inter"}},"contextual":{"options":["copy","view","chatgpt","claude","cursor","vscode"],"display":"header"},"metadata":{"timestamp":false},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/amd/gaia"},{"anchor":"Discord","icon":"discord","href":"https://discord.com/invite/5xXzkMu8Zk"},{"anchor":"PyPI","icon":"python","href":"https://pypi.org/project/amd-gaia/"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"amd-fe836e11","hasAudioNarration":false,"actualSubdomain":"amd-fe836e11","customDomains":["amd-gaia.ai"],"gitSource":{"type":"github","owner":"amd","repo":"gaia","deployBranch":"release","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ade720d531268f76f8ae9c4","collectionId":"8e2093a5-a49b-4254-ac9a-c0367535f98d","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ade720d531268f76f8ae9c4"},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6ade720d531268f76f8ae9c4","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"Documentation","count":94},{"language":"default","tag":"Python Framework","count":81},{"language":"default","tag":"SDK Reference","count":35},{"language":"default","tag":"Releases","count":31},{"language":"default","tag":"Release Notes","count":31},{"language":"default","tag":"User Guides","count":29},{"language":"default","tag":"Python Specifications","count":29},{"language":"default","tag":"Roadmap","count":25},{"language":"default","tag":"SDKs","count":20},{"language":"default","tag":"Python Reference","count":17}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/docs","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".nav-tabs .nav-tabs-item{color:rgb(156 163 175)!important}.dark .nav-tabs .nav-tabs-item{color:rgb(209 213 219)!important}.nav-tabs .nav-tabs-item:has(>div.bg-primary){color:rgb(31 41 55)!important}.dark .nav-tabs .nav-tabs-item:has(>div.bg-primary){color:rgb(229 231 235)!important}.nav-tabs .nav-tabs-item>div{height:3.5px}#navbar{border-bottom:1px solid rgb(var(--gray-500)/.3)}.dark #navbar{border-bottom:1px solid rgb(var(--gray-500)/.4)}"}],"page":{"pagePath":"guides/npu","slug":"/guides/npu","pageMetadata":{"title":"NPU Acceleration","description":"Run GAIA agents on AMD Ryzen AI NPU for power-efficient local inference","icon":"bolt","href":"/guides/npu"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Run GAIA agents on AMD Ryzen AI NPU for power-efficient local inference\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`GAIA supports running agents on your AMD Ryzen AI NPU via the `,_jsx(_components.a,{href:`https://fastflowlm.com`,children:`FastFlowLM (FLM)`}),` backend. NPU inference is power-efficient and frees your GPU for other tasks.`]}),`\n`,_jsx(Heading,{level:`2`,id:`requirements`,children:`Requirements`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Hardware:`}),` AMD Ryzen AI 300/400/Max series processor with XDNA2 NPU`,`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Strix Point, Strix Halo, Kraken Point, or Gorgon Point`}),`\n`,_jsxs(_components.li,{children:[`Ryzen AI 7000/8000/200-series (XDNA1) is `,_jsx(_components.strong,{children:`not supported`})]}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Software:`}),` `,_jsx(_components.a,{href:`https://lemonade-server.ai`,children:`Lemonade Server`}),` v10.2.0+`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Driver:`}),` Latest AMD NPU driver (firmware v1.1.0.0+)`]}),`\n`]}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Ryzen AI 7000/8000/200-series chips have XDNA1 NPUs which are not supported by FastFlowLM. Use `,_jsx(_components.code,{children:`--device gpu`}),` instead.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`linux`,children:`Linux`}),`\n`,_jsxs(_components.p,{children:[`NPU inference works on Linux the same way — run `,_jsx(_components.code,{children:`gaia init --profile npu`}),` and Lemonade Server installs the FLM backend automatically.`]}),`\n`,_jsxs(_components.p,{children:[`If Lemonade detects that your system needs additional setup (for example, the `,_jsx(_components.code,{children:`amdxdna`}),` kernel driver on older kernels), it will point you to the `,_jsx(_components.a,{href:`https://lemonade-server.ai/flm_npu_linux.html`,children:`Lemonade Linux FLM guide`}),` with distro-specific steps. Follow them, then re-run `,_jsx(_components.code,{children:`gaia init --profile npu`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`setup`,children:`Setup`}),`\n`,_jsx(_components.p,{children:`Initialize GAIA with the NPU profile:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`gaia`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` init`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --profile`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` npu`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:`This will:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Verify NPU hardware is detected`}),`\n`,_jsxs(_components.li,{children:[`Install the FLM backend (`,_jsx(_components.code,{children:`flm:npu`}),`)`]}),`\n`,_jsxs(_components.li,{children:[`Download the NPU-optimized models (`,_jsx(_components.code,{children:`gemma4-it-e2b-FLM`}),` for chat, `,_jsx(_components.code,{children:`embed-gemma-300m-FLM`}),` for documents and memory)`]}),`\n`,_jsxs(_components.li,{children:[`Install the `,_jsx(_components.a,{href:`/guides/gaia`,children:`GAIA agent`}),` if it is missing, the same agent a bare `,_jsx(_components.code,{children:`gaia init`}),` installs`]}),`\n`,_jsx(_components.li,{children:`Run a verification test and make NPU the default device`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`The Agent UI and terminal UI then have an agent to talk to. If GAIA’s download server can’t be\nreached, setup still downloads the models, then reports itself incomplete and exits\n`,_jsx(_components.code,{children:`1`}),` — run `,_jsx(_components.code,{children:`gaia init --profile npu`}),` again once the network is back. To return to the GPU, run\n`,_jsx(_components.code,{children:`gaia config set default_device gpu`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`usage`,children:`Usage`}),`\n`,_jsx(Heading,{level:`3`,id:`cli`,children:`CLI`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`11`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`11`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Chat on NPU`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`gaia`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` chat`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --device`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` npu`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Chat on GPU (default)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`gaia`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` chat`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Chat on CPU`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`gaia`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` chat`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --device`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` cpu`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Single prompt on NPU`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`gaia`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` prompt`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"Hello\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --device`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` npu`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`agent-ui`,children:`Agent UI`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Launch with `,_jsx(_components.code,{children:`gaia chat --ui`})]}),`\n`,_jsxs(_components.li,{children:[`The Agent UI uses your default device. After `,_jsx(_components.code,{children:`gaia init --profile npu`}),` that is the NPU; switch with `,_jsx(_components.code,{children:`gaia config set default_device gpu`}),` (or `,_jsx(_components.code,{children:`npu`}),`)`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`evaluation`,children:`Evaluation`}),`\n`,_jsx(_components.p,{children:`Compare agent quality across devices:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`8`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`8`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Run eval on GPU (baseline)`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`gaia`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` eval`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` agent`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --device`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` gpu`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Run eval on NPU`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`gaia`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` eval`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` agent`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --device`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` npu`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Compare results`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`gaia`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` eval`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` agent`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --compare`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` eval/results/run1/scorecard.json`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` eval/results/run2/scorecard.json`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`device-selection`,children:`Device Selection`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Device`}),_jsx(_components.th,{children:`Model`}),_jsx(_components.th,{children:`Backend`}),_jsx(_components.th,{children:`Best For`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsxs(_components.td,{children:[_jsx(_components.strong,{children:`GPU`}),` (default)`]}),_jsx(_components.td,{children:`Gemma-4-E4B-it-GGUF`}),_jsx(_components.td,{children:`llamacpp:vulkan`}),_jsx(_components.td,{children:`General use, best throughput`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`CPU`})}),_jsx(_components.td,{children:`Gemma-4-E4B-it-GGUF`}),_jsx(_components.td,{children:`llamacpp:cpu`}),_jsx(_components.td,{children:`No GPU available (slower)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:_jsx(_components.strong,{children:`NPU`})}),_jsx(_components.td,{children:`gemma4-it-e2b-FLM`}),_jsx(_components.td,{children:`flm:npu`}),_jsx(_components.td,{children:`Power efficiency, background tasks`})]})]})]}),`\n`,_jsx(Heading,{level:`3`,id:`fallback-behavior`,children:`Fallback Behavior`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[`Explicit `,_jsx(_components.code,{children:`--device npu`}),`:`]}),` fails immediately if NPU not available`]}),`\n`,_jsxs(_components.li,{children:[_jsxs(_components.strong,{children:[`Default (no `,_jsx(_components.code,{children:`--device`}),`):`]}),` uses GPU; falls back to CPU with a warning if no GPU detected`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsx(Heading,{level:`3`,id:`npu-not-detected`,children:`NPU not detected`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`❌ No AMD NPU detected. The 'npu' profile requires AMD NPU hardware`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`Verify your hardware:`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsx(_components.li,{children:`Check processor model supports XDNA2 (Ryzen AI 300+ series)`}),`\n`,_jsxs(_components.li,{children:[`Ensure NPU driver is installed: check Device Manager (Windows) or `,_jsx(_components.code,{children:`lspci | grep NPU`}),` (Linux)`]}),`\n`,_jsxs(_components.li,{children:[`Try `,_jsx(_components.code,{children:`lemonade backends`}),` to see available backends`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`flm-backend-installation-fails`,children:`FLM backend installation fails`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`❌ Failed to install backend 'flm:npu'`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`Install manually:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`lemonade`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` backends`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` install`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` flm:npu`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`3`,id:`model-not-available`,children:`Model not available`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Error pulling model: No built-in model with the name 'gemma4-it-e2b-FLM' is registered.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`The FLM backend is missing, not the model. Lemonade discovers `,_jsx(_components.code,{children:`*-FLM`}),` models\nthrough the FLM runtime itself, so until `,_jsx(_components.code,{children:`flm:npu`}),` is installed none of them\nexist to pull. Install the backend first, then pull by name:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`lemonade`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` backends`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` install`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` flm:npu`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`lemonade`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` pull`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` gemma4-it-e2b-FLM`})]}),`\n`]})})}),`\n`,_jsx(Warning,{children:_jsxs(_components.p,{children:[`Do not add `,_jsx(_components.code,{children:`--recipe flm`}),`. The recipe is baked into the built-in model and\napplied at load time; passing it turns the call into a custom-model\nregistration, which fails asking for `,_jsx(_components.code,{children:`--checkpoint`}),`.`]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"NPU Acceleration","description":"Run GAIA agents on AMD Ryzen AI NPU for power-efficient local inference","icon":"bolt","href":"/guides/npu"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Requirements","slug":"requirements","depth":2,"children":[]},{"title":"Linux","slug":"linux","depth":2,"children":[]},{"title":"Setup","slug":"setup","depth":2,"children":[]},{"title":"Usage","slug":"usage","depth":2,"children":[{"title":"CLI","slug":"cli","depth":3,"children":[]},{"title":"Agent UI","slug":"agent-ui","depth":3,"children":[]},{"title":"Evaluation","slug":"evaluation","depth":3,"children":[]}]},{"title":"Device Selection","slug":"device-selection","depth":2,"children":[{"title":"Fallback Behavior","slug":"fallback-behavior","depth":3,"children":[]}]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[{"title":"NPU not detected","slug":"npu-not-detected","depth":3,"children":[]},{"title":"FLM backend installation fails","slug":"flm-backend-installation-fails","depth":3,"children":[]},{"title":"Model not available","slug":"model-not-available","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/amd-fe836e11/8c80882acf24ecda/server.js"],"subdomain":"amd-fe836e11","siteName":"GAIA SDK","title":"NPU Acceleration - GAIA SDK","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-25T21:18:38.076Z","originalFileLocation":"guides/npu.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Run GAIA agents on AMD Ryzen AI NPU for power-efficient local inference\">\u003cmeta data-mint-head name=\"application-name\" content=\"GAIA SDK\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/amd-fe836e11/Dg3wj8yq7cr3ck3W/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/amd-fe836e11/Dg3wj8yq7cr3ck3W/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/amd-fe836e11/Dg3wj8yq7cr3ck3W/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/amd-fe836e11/Dg3wj8yq7cr3ck3W/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/amd-fe836e11/Dg3wj8yq7cr3ck3W/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/amd-fe836e11/Dg3wj8yq7cr3ck3W/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/amd-fe836e11/Dg3wj8yq7cr3ck3W/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/amd-fe836e11/Dg3wj8yq7cr3ck3W/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/amd-fe836e11/Dg3wj8yq7cr3ck3W/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"NPU Acceleration - GAIA SDK\">\u003cmeta data-mint-head property=\"og:description\" content=\"Run GAIA agents on AMD Ryzen AI NPU for power-efficient local inference\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"GAIA SDK\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://amd-gaia.ai/docs/guides/npu\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://amd-fe836e11.mintlify.app/_mintlify/api/og/v2?division=Setup+%26+Hardware\u0026amp;title=NPU+Acceleration\u0026amp;description=Run+GAIA+agents+on+AMD+Ryzen+AI+NPU+for+power-efficient+local+inference\u0026amp;theme=930f36e80adfafeb4328e01d\u0026amp;signature=9a3b2a3972aa74ce566681e8a432d87f88b2ca37dcfddb2ddfce4c78f82d58c9\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"NPU Acceleration - GAIA SDK\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Run GAIA agents on AMD Ryzen AI NPU for power-efficient local inference\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://amd-fe836e11.mintlify.app/_mintlify/api/og/v2?division=Setup+%26+Hardware\u0026amp;title=NPU+Acceleration\u0026amp;description=Run+GAIA+agents+on+AMD+Ryzen+AI+NPU+for+power-efficient+local+inference\u0026amp;theme=930f36e80adfafeb4328e01d\u0026amp;signature=9a3b2a3972aa74ce566681e8a432d87f88b2ca37dcfddb2ddfce4c78f82d58c9\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/amd-fe836e11/Dg3wj8yq7cr3ck3W/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"GAIA SDK\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#A87B2D\">\u003clink data-mint-head rel=\"canonical\" href=\"https://amd-gaia.ai/docs/guides/npu\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/guides/npu.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://amd-gaia.ai/#organization\",\"name\":\"GAIA SDK\",\"url\":\"https://amd-gaia.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/amd-fe836e11/PgPhi3UrqFX2lV53/assets/favicon.ico?fit=max\u0026auto=format\u0026n=PgPhi3UrqFX2lV53\u0026q=85\u0026s=77bcf8b2d70613766cc02f16b0e208a0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://amd-gaia.ai/docs#website\",\"name\":\"GAIA SDK\",\"url\":\"https://amd-gaia.ai/docs\",\"publisher\":{\"@id\":\"https://amd-gaia.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://amd-gaia.ai/docs/guides/npu#webpage\",\"url\":\"https://amd-gaia.ai/docs/guides/npu\",\"name\":\"NPU Acceleration\",\"description\":\"Run GAIA agents on AMD Ryzen AI NPU for power-efficient local inference\",\"dateModified\":\"2026-10-25T21:18:38.076Z\",\"isPartOf\":{\"@id\":\"https://amd-gaia.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://amd-gaia.ai/docs/guides/npu#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://amd-gaia.ai/docs/guides/npu#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Python Framework\",\"item\":\"https://amd-gaia.ai/docs/guides/install\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"User Guides\",\"item\":\"https://amd-gaia.ai/docs/guides/index\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Setup \u0026 Hardware\",\"item\":\"https://amd-gaia.ai/docs/guides/hardware-advisor\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"NPU Acceleration\",\"item\":\"https://amd-gaia.ai/docs/guides/npu\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://amd-gaia.ai/docs/guides/npu#article\",\"headline\":\"NPU Acceleration\",\"name\":\"NPU Acceleration\",\"description\":\"Run GAIA agents on AMD Ryzen AI NPU for power-efficient local inference\",\"url\":\"https://amd-gaia.ai/docs/guides/npu\",\"mainEntityOfPage\":{\"@id\":\"https://amd-gaia.ai/docs/guides/npu#webpage\"},\"dateModified\":\"2026-10-25T21:18:38.076Z\",\"publisher\":{\"@id\":\"https://amd-gaia.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://amd-gaia.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"GAIA SDK\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"GAIA SDK","nav":{"global":{"anchors":[{"anchor":"GitHub","icon":"github","href":"https://github.com/amd/gaia"},{"anchor":"Discord","icon":"discord","href":"https://discord.com/invite/5xXzkMu8Zk"},{"anchor":"PyPI","icon":"python","href":"https://pypi.org/project/amd-gaia/"}]},"tabs":[{"tab":"Documentation","groups":[{"group":"Getting Started","pages":[{"title":"Welcome","icon":"hand-wave","href":""}]},{"group":"C++ Framework","pages":[{"title":"Setup","icon":"wrench","href":"/cpp/setup"},{"title":"Quickstart","icon":"rocket","href":"/cpp/quickstart"},{"title":"Overview","icon":"code","href":"/cpp/overview"},{"title":"Integration Guide","icon":"puzzle-piece","href":"/cpp/integration"},{"title":"Testing","icon":"flask-vial","href":"/cpp/testing"},{"title":"API Reference","icon":"book-open","href":"/cpp/api-reference"},{"title":"C++ Security","icon":"lock","href":"/cpp/security"},{"group":"User Guides","pages":[{"title":"Bash Coding Agent","icon":"terminal","href":"/cpp/bash-agent"},{"title":"System Health Agent","icon":"desktop","href":"/cpp/health-agent"},{"title":"Wi-Fi Troubleshooter Agent","icon":"wifi","href":"/cpp/wifi-agent"},{"title":"Process Analyst Agent","icon":"microchip","href":"/cpp/process-agent"},{"title":"Custom Agent","icon":"sliders","href":"/cpp/custom-agent"}]}]},{"group":"Python Framework","pages":[{"title":"Install GAIA","icon":"download","href":"/guides/install"},{"title":"Setup","icon":"wrench","href":"/setup"},{"title":"Quickstart","icon":"rocket","href":"/quickstart"},{"title":"Agent UI","icon":"desktop","href":"/guides/agent-ui"},{"title":"Terminal UI","icon":"terminal","href":"/guides/tui"},{"title":"Agent Memory","icon":"brain","href":"/guides/memory"},{"group":"User Guides","pages":[{"title":"User Guides","icon":"book","href":"/guides/index"},{"group":"Setup \u0026 Hardware","pages":[{"title":"Hardware Advisor","description":"Determine what LLMs your system can run based on actual hardware","icon":"microchip","href":"/guides/hardware-advisor"},{"title":"NPU Acceleration","icon":"bolt","href":"/guides/npu"},{"title":"AMD LLM Gateway","description":"Run GAIA agents on gateway-hosted models — larger on-prem models and frontier models — alongside local inference.","href":"/guides/llm-gateway"}]},{"group":"Core Agents","pages":[{"title":"GAIA Agent","icon":"sparkles","href":"/guides/gaia"},{"title":"Complete document inventories","href":"/guides/document-extraction"},{"title":"Choose an AI provider","href":"/guides/ai-providers"},{"title":"Document Q\u0026A","icon":"file-lines","href":"/guides/chat"},{"title":"Browser Use","icon":"globe","href":"/guides/browser-use"},{"title":"Improve GAIA while using it","href":"/guides/harness-engineering"},{"title":"Voice Interaction","icon":"microphone","href":"/guides/talk"},{"title":"Transcription \u0026 Meeting Notes","icon":"file-audio","href":"/guides/transcription"}]},{"group":"Developer Tools","pages":[{"title":"Code Index","icon":"folder-magnifying-glass","href":"/guides/code-index"},{"title":"Project Map","icon":"map","href":"/guides/project-map"}]},{"group":"Connected Agents","pages":[{"title":"Email","icon":"envelope","href":"/guides/email"},{"title":"Slack","icon":"slack","href":"/guides/slack"},{"title":"Telegram Adapter","icon":"paper-plane","href":"/guides/telegram-adapter"}]},{"group":"Build \u0026 Extend","pages":[{"title":"Starter Skills","icon":"puzzle-piece","href":"/guides/starter-skills"},{"title":"Custom Agents","icon":"wand-magic-sparkles","href":"/guides/custom-agent"},{"title":"Composing Skills and Skill Sets","icon":"layer-group","href":"/guides/composing-skills"}]},{"group":"MCP Integration","pages":[{"title":"Agent UI MCP Server","icon":"plug","href":"/guides/mcp/agent-ui"},{"title":"TUI Control MCP Server","icon":"terminal","href":"/guides/mcp/tui"},{"title":"MCP Client","href":"/guides/mcp/client"},{"title":"Windows MCP System Health Agent","icon":"heart-pulse","href":"/guides/mcp/windows-system-health"}]}]},{"group":"Connectors","pages":[{"title":"Connectors","icon":"plug","href":"/connectors/index"},{"title":"Google","icon":"google","href":"/connectors/google"},{"title":"Microsoft","icon":"microsoft","href":"/connectors/microsoft"},{"title":"GitHub","icon":"github","href":"/connectors/github"},{"title":"Tavily","icon":"globe","href":"/connectors/tavily"},{"title":"Connections Security Model","icon":"shield","href":"/security/connections"},{"title":"OAuth Connection Threat Model","icon":"lock","href":"/security/connectors"}]},{"group":"Agent Eval","pages":[{"title":"Agent Eval","icon":"microscope","href":"/guides/eval"},{"title":"Scenario Authoring","icon":"file-pen","href":"/guides/eval-scenarios"},{"title":"CI/CD Integration","icon":"gears","href":"/guides/eval-ci"}]},{"group":"Playbooks","pages":[{"title":"GAIA Playbooks","icon":"book-atlas","href":"/playbooks/index"},{"group":"Hardware Advisor Agent","pages":[{"title":"Building a Hardware Advisor Agent","icon":"microchip","href":"/playbooks/hardware-advisor/index"}]},{"group":"Document Q\u0026A Agent","pages":[{"title":"Part 1: Getting Started with Document Q\u0026A Agents","icon":"book-open-reader","href":"/playbooks/chat-agent/part-1-getting-started"},{"title":"Part 2: Advanced Features \u0026 Customization","icon":"wrench","href":"/playbooks/chat-agent/part-2-advanced-features"},{"title":"Part 3: Deployment \u0026 Optimization","icon":"graduation-cap","href":"/playbooks/chat-agent/part-3-deployment"}]},{"group":"Custom Installer","pages":[{"title":"Custom Installer Playbook","icon":"play","href":"/playbooks/custom-installer/index"}]}]},{"group":"SDK Reference","pages":[{"title":"SDK Reference","icon":"book","href":"/sdk/index"},{"group":"Core Concepts","pages":[{"title":"Understanding the Agent System","icon":"robot","href":"/sdk/core/agent-system"},{"title":"Creating Tools: Giving Agents Superpowers","icon":"screwdriver-wrench","href":"/sdk/core/tools"},{"title":"Output Handlers","icon":"terminal","href":"/sdk/core/console"},{"title":"Agent Patterns Cookbook","icon":"code","href":"/sdk/patterns"}]},{"group":"SDKs","pages":[{"title":"Agent SDK","icon":"comments","href":"/sdk/sdks/chat"},{"title":"Memory SDK","icon":"brain","href":"/sdk/sdks/memory"},{"title":"Agent UI SDK","icon":"desktop","href":"/sdk/sdks/agent-ui"},{"title":"RAG: Teaching Your Agent About Documents","href":"/sdk/sdks/rag"},{"title":"Code Index SDK","icon":"folder-magnifying-glass","href":"/sdk/sdks/code-index"},{"title":"MCP Client","icon":"plug","href":"/sdk/sdks/mcp"},{"title":"LLM Integration","icon":"brain","href":"/sdk/sdks/llm"},{"title":"Vision-Language Models","icon":"eye","href":"/sdk/sdks/vlm"},{"title":"Audio \u0026 Voice","href":"/sdk/sdks/audio"},{"title":"Governance: Optional Policy Layer for Agents","href":"/sdk/sdks/governance"},{"title":"Skills SDK","href":"/sdk/sdks/skills"}]},{"group":"Infrastructure","pages":[{"title":"API Server","href":"/sdk/infrastructure/api-server"},{"title":"MCP Integration","href":"/sdk/infrastructure/mcp"},{"title":"Connectors SDK","href":"/sdk/infrastructure/connectors"}]},{"group":"Agents","pages":[{"title":"Specialized","href":"/sdk/agents/specialized"},{"title":"Talk SDK","href":"/sdk/agents/talk"}]},{"group":"Mixins \u0026 Utilities","pages":[{"title":"Tool Mixins","icon":"puzzle-piece","href":"/sdk/mixins/tool-mixins"},{"title":"DatabaseMixin","icon":"database","href":"/sdk/mixins/database-mixin"},{"title":"FileWatcher","icon":"file-magnifying-glass","href":"/sdk/utils/file-watcher"}]},{"group":"Guides","pages":[{"title":"Application Packaging","icon":"box","href":"/sdk/packaging"},{"title":"Configuration","icon":"gear","href":"/sdk/configuration"},{"title":"Testing","icon":"vial","href":"/sdk/testing"},{"title":"Performance Analysis Plotter","icon":"chart-bar","href":"/sdk/performance-analysis-plotter"},{"title":"Security","icon":"shield-halved","href":"/sdk/security"},{"title":"Best Practices","icon":"star","href":"/sdk/best-practices"}]},{"group":"Resources","pages":[{"title":"Complete Examples","icon":"lightbulb","href":"/sdk/examples"},{"title":"Advanced Patterns","icon":"diagram-project","href":"/sdk/advanced-patterns"},{"title":"API Reference Summary","icon":"book-open","href":"/sdk/api-reference"},{"title":"Migration Guide","icon":"arrow-right-arrow-left","href":"/sdk/migration"},{"title":"Troubleshooting","icon":"circle-question","href":"/sdk/troubleshooting"}]}]}]}]},{"tab":"Python Specifications","pages":[{"title":"Python Specifications","href":"/spec/agent-base"}]},{"tab":"Python Reference","pages":[{"title":"Python Reference","href":"/reference/cli"}]},{"tab":"Python Deployment","pages":[{"title":"Python Deployment","href":"/integrations/vscode"}]},{"tab":"Roadmap","pages":[{"title":"Roadmap","href":"/roadmap"}]},{"tab":"Releases","pages":[{"title":"Releases","href":"/releases"}]}]},"title":"NPU Acceleration - GAIA SDK","buildId":"dpl_GvhK4qVXq51DpfYJLCtPpYNN4YHN","deploymentId":"dpl_GvhK4qVXq51DpfYJLCtPpYNN4YHN","dynamics":[],"chunks":[]}