Expected: a synthetic mailbox is seeded; a scripted assistant walks first contact →
approval → structured reads → a free-form question. No network required.
4. Verify
export FAU_HOME=/tmp/fau-demo.venv/bin/python -m fedagent.cli status
You should see node identity and demo store stats under /tmp/fau-demo.
What you just ran
A node process with an in-memory/demo path — not a full Mac app install, not a
public relay registration.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Federated Agent Use","colors":{"primary":"#0F766E","light":"#14B8A6","dark":"#115E59"},"logo":{"light":"https://mintcdn.com/fau-run/n0ZgQ1xpeLq3W-7O/developer/logo/light.svg?fit=max\u0026auto=format\u0026n=n0ZgQ1xpeLq3W-7O\u0026q=85\u0026s=33d4415571dd840bb51fac0e33c8aed4","dark":"https://mintcdn.com/fau-run/n0ZgQ1xpeLq3W-7O/developer/logo/dark.svg?fit=max\u0026auto=format\u0026n=n0ZgQ1xpeLq3W-7O\u0026q=85\u0026s=b529c00d20e094938cd65c84edc1557f"},"favicon":"https://mintcdn.com/fau-run/n0ZgQ1xpeLq3W-7O/developer/favicon.svg?fit=max\u0026auto=format\u0026n=n0ZgQ1xpeLq3W-7O\u0026q=85\u0026s=eff4799d390d3b4450ed9a84a582ca29","navbar":{"links":[{"href":"https://discord.gg/ne49b7JzG","label":"Join Discord"},{"href":"https://relay.fau.run/v1/health","label":"Relay health"}]},"footer":{"socials":{}},"seo":{"metatags":{"canonical":"https://docs.fau.run"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"fau-run","hasAudioNarration":false,"actualSubdomain":"fau-run","customDomains":["docs.fau.run"],"gitSource":{"type":"github","owner":"ranagwho","repo":"federated-agent-use","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6ab4e4515367878c016f9a03","clientVersion":"0.0.4143","searchFilterCounts":[{"language":"default","tag":"Agents","count":16},{"language":"default","tag":"Developers","count":15},{"language":"default","tag":"Protocol","count":8},{"language":"default","tag":"Reference","count":4},{"language":"default","tag":"Start here","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"/developer","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"developer/developers/getting-started","slug":"/developer/developers/getting-started","pageMetadata":{"title":"Getting started","description":"Reach first success locally — install the node package and run the demo without Gmail.","href":"/developer/developers/getting-started"},"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: \"Reach first success locally — install the node package and run the demo without Gmail.\"\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`,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}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Purpose:`}),` prove the stack runs on your machine before you deploy a relay or build\nclients.`]}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Audience:`}),` engineers cloning this repository.`]}),`\n`,_jsx(Heading,{level:`2`,id:`prerequisites`,children:`Prerequisites`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Python 3.11+ recommended`}),`\n`,_jsx(_components.li,{children:`Git`}),`\n`,_jsx(_components.li,{children:`No Gmail required for the demo`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`1-clone-the-repository`,children:`1. Clone the repository`}),`\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:`git`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` clone`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://github.com/ranagwho/Federated-Agent-Use.git`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`cd`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` Federated-Agent-Use`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`2-install-the-node-package`,children:`2. Install the node package`}),`\n`,_jsx(_components.p,{children:`From the repo root:`}),`\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:`python3`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -m`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` venv`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` .venv`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`.venv/bin/pip`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` install`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -e`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` node`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`3-run-the-seeded-demo`,children:`3. Run the seeded demo`}),`\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:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`export`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` FAU_HOME`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`/`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`tmp`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`/`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`fau-demo`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`.venv/bin/python`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -m`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` fedagent.cli`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` demo`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`Expected:`}),` a synthetic mailbox is seeded; a scripted assistant walks first contact →\napproval → structured reads → a free-form question. No network required.`]}),`\n`,_jsx(Heading,{level:`2`,id:`4-verify`,children:`4. Verify`}),`\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:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`export`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` FAU_HOME`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`/`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`tmp`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`/`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`fau-demo`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`.venv/bin/python`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -m`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` fedagent.cli`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` status`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`You should see node identity and demo store stats under `,_jsx(_components.code,{children:`/tmp/fau-demo`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`what-you-just-ran`,children:`What you just ran`}),`\n`,_jsxs(_components.p,{children:[`A `,_jsx(_components.strong,{children:`node`}),` process with an in-memory/demo path — not a full Mac app install, not a\npublic relay registration.`]}),`\n`,_jsx(Heading,{level:`2`,id:`next-pick-one`,children:`Next (pick one)`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Goal`}),_jsx(_components.th,{children:`Page`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Real Mac install with Gmail`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/developer/developers/run-node`,children:`Run a node`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Public rendezvous`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/developer/developers/run-relay`,children:`Run a relay`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Menu bar packaging`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/developer/developers/build-macos`,children:`Build the macOS client`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Phone app`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/developer/developers/build-mobile`,children:`Build a mobile client`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`Change code`}),_jsx(_components.td,{children:_jsx(_components.a,{href:`/developer/developers/extend`,children:`Extend the codebase`})})]})]})]})]})}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":"Getting started","description":"Reach first success locally — install the node package and run the demo without Gmail.","href":"/developer/developers/getting-started"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Prerequisites","slug":"prerequisites","depth":2,"children":[]},{"title":"1. Clone the repository","slug":"1-clone-the-repository","depth":2,"children":[]},{"title":"2. Install the node package","slug":"2-install-the-node-package","depth":2,"children":[]},{"title":"3. Run the seeded demo","slug":"3-run-the-seeded-demo","depth":2,"children":[]},{"title":"4. Verify","slug":"4-verify","depth":2,"children":[]},{"title":"What you just ran","slug":"what-you-just-ran","depth":2,"children":[]},{"title":"Next (pick one)","slug":"next-pick-one","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"fau-run","siteName":"Federated Agent Use","title":"Getting started - Federated Agent Use","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-22T12:15:28.748Z","originalFileLocation":"developer/developers/getting-started.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=\"Reach first success locally — install the node package and run the demo without Gmail.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Federated Agent Use\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/fau-run/2s3Wu25hw7zC2Z0Y/_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=\"/mintlify-assets/_mintlify/favicons/fau-run/2s3Wu25hw7zC2Z0Y/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fau-run/2s3Wu25hw7zC2Z0Y/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/fau-run/2s3Wu25hw7zC2Z0Y/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/fau-run/2s3Wu25hw7zC2Z0Y/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/fau-run/2s3Wu25hw7zC2Z0Y/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/fau-run/2s3Wu25hw7zC2Z0Y/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/fau-run/2s3Wu25hw7zC2Z0Y/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/fau-run/2s3Wu25hw7zC2Z0Y/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Getting started - Federated Agent Use\">\u003cmeta data-mint-head property=\"og:description\" content=\"Reach first success locally — install the node package and run the demo without Gmail.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Federated Agent Use\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.fau.run/developer/developers/getting-started\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://fau-run.mintlify.site/_mintlify/api/og/v2?division=Developers\u0026amp;title=Getting+started\u0026amp;description=Reach+first+success+locally+%E2%80%94+install+the+node+package+and+run+the+demo+without+Gmail.\u0026amp;theme=b0edd6ae2440834bc4ff457a\u0026amp;signature=9f0a958652fb4f1b4fb9f940db1dd8aa858e4bb743060fe2ffa45476e55c04fd\">\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=\"Getting started - Federated Agent Use\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Reach first success locally — install the node package and run the demo without Gmail.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://fau-run.mintlify.site/_mintlify/api/og/v2?division=Developers\u0026amp;title=Getting+started\u0026amp;description=Reach+first+success+locally+%E2%80%94+install+the+node+package+and+run+the+demo+without+Gmail.\u0026amp;theme=b0edd6ae2440834bc4ff457a\u0026amp;signature=9f0a958652fb4f1b4fb9f940db1dd8aa858e4bb743060fe2ffa45476e55c04fd\">\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=\"/mintlify-assets/_mintlify/favicons/fau-run/2s3Wu25hw7zC2Z0Y/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Federated Agent Use\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0F766E\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.fau.run/developer/developers/getting-started\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/developer/developers/getting-started.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.fau.run/#organization\",\"name\":\"Federated Agent Use\",\"url\":\"https://docs.fau.run\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/fau-run/n0ZgQ1xpeLq3W-7O/developer/logo/light.svg?fit=max\u0026auto=format\u0026n=n0ZgQ1xpeLq3W-7O\u0026q=85\u0026s=33d4415571dd840bb51fac0e33c8aed4\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.fau.run#website\",\"name\":\"Federated Agent Use\",\"url\":\"https://docs.fau.run\",\"publisher\":{\"@id\":\"https://docs.fau.run/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.fau.run/developer/developers/getting-started#webpage\",\"url\":\"https://docs.fau.run/developer/developers/getting-started\",\"name\":\"Getting started\",\"description\":\"Reach first success locally — install the node package and run the demo without Gmail.\",\"dateModified\":\"2026-09-22T12:15:28.748Z\",\"isPartOf\":{\"@id\":\"https://docs.fau.run#website\"},\"breadcrumb\":{\"@id\":\"https://docs.fau.run/developer/developers/getting-started#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.fau.run/developer/developers/getting-started#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Developers\",\"item\":\"https://docs.fau.run/developer/developers\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Getting started\",\"item\":\"https://docs.fau.run/developer/developers/getting-started\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.fau.run/developer/developers/getting-started#article\",\"headline\":\"Getting started\",\"name\":\"Getting started\",\"description\":\"Reach first success locally — install the node package and run the demo without Gmail.\",\"url\":\"https://docs.fau.run/developer/developers/getting-started\",\"mainEntityOfPage\":{\"@id\":\"https://docs.fau.run/developer/developers/getting-started#webpage\"},\"dateModified\":\"2026-09-22T12:15:28.748Z\",\"publisher\":{\"@id\":\"https://docs.fau.run/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.fau.run#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Federated Agent Use\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Federated Agent Use\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/developer/developers/getting-started.md","siteName":"Federated Agent Use","nav":{"global":null,"groups":[{"group":"Start here","pages":[{"title":"Federated Agent Use","href":"/developer/index"},{"title":"Concepts","href":"/developer/concepts"}]},{"group":"Agents","pages":[{"title":"For agents","href":"/developer/agents/index"},{"title":"Connect your agent","href":"/developer/agents/getting-started"},{"title":"Python Agent SDK","href":"/developer/agents/python-sdk"},{"title":"Resolve an address","href":"/developer/connect/resolve"},{"title":"Agent identity","href":"/developer/connect/identity"},{"title":"Enroll with a claim code","href":"/developer/connect/enroll"},{"title":"Request signing","href":"/developer/connect/signing"},{"title":"Transport","href":"/developer/connect/transport"},{"title":"Offline queue","href":"/developer/connect/offline-queue"},{"title":"Outstanding requests","href":"/developer/connect/outstanding-requests"},{"title":"Tools overview","href":"/developer/tools/overview"},{"title":"Structured tools","href":"/developer/tools/structured"},{"title":"ask","href":"/developer/tools/ask"},{"title":"Excerpts and sending","href":"/developer/tools/excerpts-and-send"},{"title":"Approvals","href":"/developer/tools/approvals"},{"title":"Integration checklist","href":"/developer/reference/checklist"}]},{"group":"Developers","pages":[{"title":"For protocol developers","description":"Run a node or relay, build macOS/iOS clients, or extend the FAU codebase.","href":"/developer/developers/index"},{"title":"Getting started","href":"/developer/developers/getting-started"},{"title":"Run a node","description":"Stand up a user mail node — local CLI, Mac app packaging, relay registration, and verification.","href":"/developer/developers/run-node"},{"title":"Run a relay","href":"/developer/developers/run-relay"},{"title":"Build the macOS client","href":"/developer/developers/build-macos"},{"title":"Build a mobile client","href":"/developer/developers/build-mobile"},{"title":"Extend the codebase","href":"/developer/developers/extend"},{"title":"Product architecture (non-normative)","href":"/developer/developers/product-architecture"},{"title":"Build an approval app","href":"/developer/apps/overview"},{"title":"App quickstart","href":"/developer/apps/quickstart"},{"title":"Pairing","href":"/developer/apps/pairing"},{"title":"Device signing","href":"/developer/apps/signing"},{"title":"Phone API","href":"/developer/apps/phone-api"},{"title":"Push notifications","href":"/developer/apps/push"},{"title":"App checklist","href":"/developer/apps/checklist"}]},{"group":"Protocol","pages":[{"title":"Protocol overview","href":"/developer/protocol/overview"},{"title":"Wire specification (fau/1)","href":"/developer/protocol/spec"},{"title":"Security","href":"/developer/protocol/security"},{"title":"Relay","href":"/developer/protocol/relay"},{"title":"Node","href":"/developer/protocol/node"},{"title":"macOS client","href":"/developer/protocol/client-macos"},{"title":"Mobile clients (iOS / Android)","href":"/developer/protocol/client-mobile"},{"title":"Dashboard API","href":"/developer/protocol/dashboard"}]},{"group":"Reference","pages":[{"title":"Device signing vectors","href":"/developer/reference/device-signing"},{"title":"Errors","href":"/developer/reference/errors"},{"title":"Relay HTTP API","href":"/developer/reference/relay-api"},{"title":"Implementation notes","href":"/developer/reference/openapi-notes"}]}]},"basePath":"","title":"Getting started - Federated Agent Use","buildId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","deploymentId":"dpl_Fyv1NbzwP68g2bEH2Roy98uY1zmE","dynamics":[],"chunks":[]}