The desktop client for 01 provides a simple way to interact with the 01 light server using your computer. There are two main ways to use the desktop client:
To simulate the 01 light hardware device on your desktop, run:
poetry run 01 --client
This will start the client in simulation mode. You can hold the CTRL key to talk to the 01 light server, simulating the button press on the physical device.
To run both the server and client simultaneously, use:
poetry run 01
This command starts both the 01 light server and the desktop client, allowing you to interact with the system immediately. The client interface will guide you through the interaction process.
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"01","colors":{"primary":"#000000","light":"#FFFFFF","dark":"#000000"},"favicon":"/favicon.png","logo":{"light":"https://mintcdn.com/01-44/6QEW7qBcSGph67UE/logo/Z-icon-black.png?fit=max\u0026auto=format\u0026n=6QEW7qBcSGph67UE\u0026q=85\u0026s=1bf431c34fd665af78f6f0b4731ae61c","dark":"https://mintcdn.com/01-44/6QEW7qBcSGph67UE/logo/Z-icon-white.png?fit=max\u0026auto=format\u0026n=6QEW7qBcSGph67UE\u0026q=85\u0026s=4382028cf7f0866ff3ee0e48f30dae21"},"background":{"decoration":null,"color":{"light":"#FFFFFF","dark":"#000000"}},"navbar":{"links":[{"label":"GitHub","href":"https://github.com/OpenInterpreter/01"}],"primary":{"type":"button","label":"Join Discord","href":"https://discord.com/invite/Hvz9Axh84z"}},"footer":{"socials":{"twitter":"https://x.com/OpenInterpreter","github":"https://github.com/OpenInterpreter/01","discord":"https://discord.com/invite/Hvz9Axh84z"}},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"01-44","hasAudioNarration":false,"actualSubdomain":"01-44","customDomains":["01.openinterpreter.com"],"gitSource":{"type":"github","owner":"openinterpreter","repo":"01","deployBranch":"main","contentDirectory":"docs","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a20c47b0e965794a0a74db8","collectionId":"515bb4fb-b5a6-4657-ab0c-a358aa7b2fbc","schemaVersion":"v2"},"feedback":{"edits":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6a20c47b0e965794a0a74db8:success","clientVersion":"0.0.3971","searchFilterCounts":[{"language":"default","tag":"Hardware","count":11},{"language":"default","tag":"01 Light","count":6},{"language":"default","tag":"Client","count":5},{"language":"default","tag":"Server","count":5},{"language":"default","tag":"Safety","count":3},{"language":"default","tag":"Legal","count":2},{"language":"default","tag":"Setup","count":2},{"language":"default","tag":"Troubleshooting","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"editor-v7-file-tree","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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":".font-extrabold,.h1,.h2,.h3,.h4,.h5,.h6{font-weight:600}.body{font-weight:400}"}],"page":{"pagePath":"client/desktop","slug":"/client/desktop","pageMetadata":{"title":null,"description":null,"href":"/client/desktop"},"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`,p:`p`,pre:`pre`,span:`span`,..._provideComponents(),...props.components},{CodeBlock,Heading,Info}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);return _jsxs(_Fragment,{children:[_jsxs(Info,{children:[`This client uses the `,_jsx(_components.a,{href:`/server/light`,children:`light`}),` server.`]}),`\n`,_jsx(_components.p,{children:`The desktop client for 01 provides a simple way to interact with the 01 light server using your computer. There are two main ways to use the desktop client:`}),`\n`,_jsx(Heading,{level:`2`,id:`simulating-01-light-hardware`,children:`Simulating 01 Light Hardware`}),`\n`,_jsx(_components.p,{children:`To simulate the 01 light hardware device on your desktop, run:`}),`\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:`poetry run 01 --client`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`This will start the client in simulation mode. You can hold the CTRL key to talk to the 01 light server, simulating the button press on the physical device.`}),`\n`,_jsx(Heading,{level:`2`,id:`running-both-server-and-client`,children:`Running Both Server and Client`}),`\n`,_jsx(_components.p,{children:`To run both the server and client simultaneously, use:`}),`\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:`poetry run 01`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(_components.p,{children:`This command starts both the 01 light server and the desktop client, allowing you to interact with the system immediately. The client interface will guide you through the interaction process.`})]})}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":null,"description":null,"href":"/client/desktop"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Simulating 01 Light Hardware","slug":"simulating-01-light-hardware","depth":2,"children":[]},{"title":"Running Both Server and Client","slug":"running-both-server-and-client","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"01-44","siteName":"01","title":"Desktop - 01","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-01-07T01:40:35.490Z","originalFileLocation":"client/desktop.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=\"application-name\" content=\"01\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/01-44/beJ3A96VWdxPqCVM/_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/01-44/beJ3A96VWdxPqCVM/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/01-44/beJ3A96VWdxPqCVM/_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/01-44/beJ3A96VWdxPqCVM/_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/01-44/beJ3A96VWdxPqCVM/_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/01-44/beJ3A96VWdxPqCVM/_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/01-44/beJ3A96VWdxPqCVM/_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/01-44/beJ3A96VWdxPqCVM/_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/01-44/beJ3A96VWdxPqCVM/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Desktop - 01\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"01\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://01.openinterpreter.com/client/desktop\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://01-44.mintlify.app/_mintlify/api/og/v2?division=Client\u0026amp;title=Desktop\u0026amp;theme=89b6fb71acf0d8ced9247ca6\u0026amp;signature=085764d1381c793b84e9b79eed45fd68487aee0337f11942d1215c0ee8729e36\">\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=\"Desktop - 01\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://01-44.mintlify.app/_mintlify/api/og/v2?division=Client\u0026amp;title=Desktop\u0026amp;theme=89b6fb71acf0d8ced9247ca6\u0026amp;signature=085764d1381c793b84e9b79eed45fd68487aee0337f11942d1215c0ee8729e36\">\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/01-44/beJ3A96VWdxPqCVM/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"01\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#000000\">\u003clink data-mint-head rel=\"canonical\" href=\"https://01.openinterpreter.com/client/desktop\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/client/desktop.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://01.openinterpreter.com/#organization\",\"name\":\"01\",\"url\":\"https://01.openinterpreter.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/01-44/6QEW7qBcSGph67UE/logo/Z-icon-black.png?fit=max\u0026auto=format\u0026n=6QEW7qBcSGph67UE\u0026q=85\u0026s=1bf431c34fd665af78f6f0b4731ae61c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://01.openinterpreter.com#website\",\"name\":\"01\",\"url\":\"https://01.openinterpreter.com\",\"publisher\":{\"@id\":\"https://01.openinterpreter.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://01.openinterpreter.com/client/desktop#webpage\",\"url\":\"https://01.openinterpreter.com/client/desktop\",\"name\":\"Desktop\",\"dateModified\":\"2026-01-07T01:40:35.490Z\",\"isPartOf\":{\"@id\":\"https://01.openinterpreter.com#website\"},\"breadcrumb\":{\"@id\":\"https://01.openinterpreter.com/client/desktop#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://01.openinterpreter.com/client/desktop#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Client\",\"item\":\"https://01.openinterpreter.com/client/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Desktop\",\"item\":\"https://01.openinterpreter.com/client/desktop\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://01.openinterpreter.com/client/desktop#article\",\"headline\":\"Desktop\",\"name\":\"Desktop\",\"url\":\"https://01.openinterpreter.com/client/desktop\",\"mainEntityOfPage\":{\"@id\":\"https://01.openinterpreter.com/client/desktop#webpage\"},\"dateModified\":\"2026-01-07T01:40:35.490Z\",\"publisher\":{\"@id\":\"https://01.openinterpreter.com/#organization\"},\"isPartOf\":{\"@id\":\"https://01.openinterpreter.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"01\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"01","nav":{"global":null,"groups":[{"group":"Setup","pages":[{"title":"Introduction","href":"/setup/introduction"},{"title":"Installation","href":"/setup/installation"}]},{"group":"Safety","pages":[{"title":"Introduction","href":"/safety/introduction"},{"title":"Risks","href":"/safety/risks"},{"title":"Measures","href":"/safety/measures"}]},{"group":"Server","pages":[{"title":"Introduction","href":"/server/introduction"},{"title":"Livekit Server","href":"/server/livekit"},{"title":"Light Server","href":"/server/light"},{"title":"Configure","href":"/server/configure"},{"title":"Flags","href":"/server/flags"}]},{"group":"Client","pages":[{"title":"Introduction","href":"/client/introduction"},{"title":"Android \u0026 iOS","description":"A react-native client for the 01","href":"/client/android-ios"},{"title":null,"href":"/client/desktop"},{"title":"ESP32","description":"How to setup the ESP32","href":"/client/esp32"},{"title":"Native iOS App","href":"/client/native-ios"}]},{"group":"Hardware","pages":[{"title":"Introduction","href":"/hardware/introduction"},{"group":"01 Light","pages":[{"title":"Introduction","href":"/hardware/01-light/introduction"},{"title":"Materials","href":"/hardware/01-light/materials"},{"title":"Case","href":"/hardware/01-light/case"},{"title":"Assembly","href":"/hardware/01-light/assembly"},{"title":"Chip","href":"/hardware/01-light/chip"},{"title":"Connect","href":"/hardware/01-light/connect"}]},{"title":"Desktop","href":"/hardware/desktop"},{"title":"Mini Phone","href":"/hardware/mini-phone"},{"title":"Grimes Build","href":"/hardware/grimes"},{"title":"Custom Hardware","href":"/hardware/custom"}]},{"group":"Troubleshooting","pages":[{"title":"FAQ","href":"/troubleshooting/faq"}]},{"group":"Legal","pages":[{"title":"Privacy Policy","href":"/legal/privacy-policy"},{"title":"Terms of Service","href":"/legal/terms-of-service"}]}]},"title":"Desktop - 01","buildId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","deploymentId":"dpl_DFJrtvUi8HS5F9nkooKuDJsuD5BM","dynamics":[],"chunks":[]}