docs/help

questions

the short answers, with a link to the long one.

the basics

what is dusk bot?

a desktop app where you run a team of ai bots and text them like teammates. each bot has a name, a job, a memory and, if you want, a computer of its own. getting started takes about two minutes.

how is this different from a chatbot?

a chatbot answers. a bot here has a job it keeps, signs in to your tools, works on a computer, runs on a schedule and remembers how you like things done.

is it really free?

yes, for personal use. the app runs on your computer or your own server with every feature. you only pay for a cloud computer or a work license. see plans and billing.

which systems does it run on?

macos 12 or later, windows 10 or 11, and ubuntu 24.04. you can text your bots from an iphone or an android phone too. see install and the phone app.

the ai

which ai does it use?

the one you already have. sign in with claude, chatgpt, gemini, grok and others, or add an api key, or use a model you run yourself. see connecting an ai.

do i need a paid ai plan?

you need some ai to connect: a subscription, an api key or a local model. dusk bot does not come with one.

can each bot use a different ai?

yes. every bot has its own model, and you can swap it at any time. the bot keeps its chats, files and memory.

does dusk bot see what i say to my bots?

no. what you say goes straight from the machine your bots run on to your ai provider. see privacy and where data lives.

what bots can do

which apps can a bot use?

60+ to start: gmail, google calendar, slack, notion, github, linear, figma, stripe and more. you connect an app once and pick which bots may use it. you can also add any mcp server. see connected apps.

is it safe to let bots click around?

bots ask before the scary stuff: sending, buying, deleting. you choose how much each bot may do without asking, you can watch it work, and you can take the mouse back at any moment. see permissions and safety.

can a bot work while i sleep?

yes, with a routine. on your own computer the computer has to be awake. on dusk cloud or your own server, routines run around the clock.

can bots work together?

yes. put several in a group chat and they hand work to each other.

can i talk to a bot instead of typing?

yes. a bot can read its replies aloud, and you can call it. see voice and calls.

where it runs

where does my data go?

nowhere, unless you choose a cloud computer. bots, chats, files and memory live on your machine or your own server.

what is a cloud computer?

a computer we host for your bots, so routines keep running when your laptop is closed. see dusk cloud.

can i run it on my own server?

yes. open the app, add your own server, and paste the line it shows. that is free too. see your own server.

do i need an account?

not for the free plan. an account is only for buying a plan and for seeing your workspaces side by side. see your account.

can i move my bots later?

yes. you can move from your computer to a cloud or a server and back, and you can export a backup of everything at any time.

plans

what counts as using it for work?

using dusk bot at or for a business. that needs a license. pro includes one for one person, and teams get one with a team plan. the license has the exact words.

who bills me for ai usage?

your ai provider, on your plan with them. a dusk plan pays for the cloud computer and the license.

can i cancel?

any time, from the billing page of your account. see plans and billing.

the project

is dusk bot open source?

no. it is source-available, under the polyform strict license: free for personal use, and the license does not allow changing it or passing it on. using it for work needs a separate license. see the license.

how do i report a security problem?

write to [email protected]. the security page says what to include and what you can expect.

stuck? write to [email protected] and a person answers.