How can we help?

Search the questions people ask most, or ask Casama Help. It answers from our docs.

Updated

Getting started

What is Casama?

Casama gives you AI teammates, called bots, that keep working after you close the chat. Each bot has its own instructions, memory, skills and a sandboxed Linux computer. It can research, write, code, browse and run tasks on a schedule, and it asks before doing anything risky.

You can use it on Casama Cloud, the hosted service, or run the whole thing on your own server for free. See What is Casama.

How is Casama different from a chat assistant?

A chat assistant answers in a text box while you watch. A Casama bot has its own computer, your tools, a memory and a schedule, so it does the work itself: fills in the form, drafts the email, builds the page, and comes back when it's done or needs you.

It works on schedules and triggers when you're not there, reaches out first with a morning brief and suggestions, uses your tools through connections, and asks you before risky steps. What it makes is kept in the Library. You can run it yourself, on any model.

What can my first bot do on day one?

The first time you sign in, Casama asks what bots should call you, then makes a workspace named after you and a personal bot called Casama, and opens its chat. On Casama Cloud the bot already has a model, so you can give it work straight away. The chat starts with tiles to Connect your apps and a few starter requests you can tap.

It can use its computer to research, write, code and keep files, make pages and documents, and set up reminders and routines from a plain request such as "Remind me in 20 minutes to call Ana". Its check-ins are on: each morning it sends a brief, and during the day it offers suggestions you accept or dismiss. See Your first bot.

Which devices can I use it on?

There are apps for iPhone, iPad, Android, Mac, Windows and Linux, and a web app at app.casama.ai. The casama CLI works in the terminal and in scripts: install it with brew install stackwares/tap/casama or download it from the releases page.

You can also reach your bots from chat apps such as Slack, Telegram and WhatsApp, and from AI coding tools over MCP. A few things need the desktop app: signing in with a ChatGPT plan, lending your own computer to bots, and iMessage, which needs a Mac. See Quick start.

Should I get the Mac app from the website or the Mac App Store?

Get it from the website (casama.ai/download) unless you prefer the App Store. The website version can do everything. Apple's App Store requires a sandbox, which keeps an app inside its own box, so the App Store version leaves out the features that reach outside the app:

From the websiteMac App Store
Chat, bots, voice, widgets, notificationsYesYes
Let bots use your Mac (terminal, files, browser, desktop apps)YesNo
Coding agents and local MCP servers on your MacYesNo
Run your own Casama server on this Mac (Run on This Mac)YesNo
Quick ask reads the front window and your selectionYesNo
Watch folders for new filesYesNo
UpdatesThe app updates itselfThrough the App Store
How you payWeb checkoutIn-app purchase (in the US, a web checkout link too)

Your account, bots and chats live on the server, so you can switch later: install the other version and sign in. A plan you bought in one version stays with the store you bought it in. To manage or cancel it, go back to that store (see Where do I pay?).

Which languages does Casama support?

The apps are in English only for now.

Do I need technical skills?

Not for Casama Cloud. Sign in with Google, Apple or your email and ask a bot for what you need in plain words. It sets up its own routines when you ask, and most apps connect with one sign-in. Connecting some chat apps means pasting keys from that app's developer settings.

Self-hosting takes one command in a terminal. On a Mac or Linux computer, the desktop app can also run a server for you with no terminal: start Docker Desktop, then choose Run Casama on This Computer on the sign-in screen. See Quick start.

Is Casama open source?

Yes. The product (server, worker, agent and apps) is licensed under AGPL-3.0, and the SDKs, CLI, MCP server, plugin kit, examples and these docs under Apache-2.0, so what you build on Casama can use any license. The ee/ folder (enterprise features such as SAML single sign-on and audit-log export) is source-available under the Casama Enterprise License. Running Casama, even for a business, has no license cost; if you change the product and let others use it, you share your changes under AGPL-3.0 too. A commercial license is available. The code is on GitHub. See Open source and LICENSING.md.

Why is Casama Cloud invite-only?

We're letting people in as we add capacity, so Casama stays fast for everyone who is in. Running Casama on your own server is open to everyone, with no invite and no waitlist. See Getting an invite.

How do I get an invite?

Join the waitlist at casama.ai/waitlist and we'll email you once, when it's your turn. Or ask someone who uses Casama: every member has a few invites to share.

I have an invite code. What now?

Go to casama.ai/waitlist and enter it with your email. Then sign in with that address. Google, Apple and the email link all work, as long as it's the same address.

Plans & billing

Is it free?

Self-hosting is free, with no paywall or limits; you pay only your model provider and your server. A local model costs nothing at all. Casama Link, which puts a server on your own computer on your phone, is free too.

Casama Cloud, the hosted service, has a Free plan that doesn't end: $1 of credits every month, 3 bots and one cloud computer with 5 hours of computer time. Three paid plans add more. See Usage, budgets and plans.

What plans are there and what do they cost?

Casama Cloud has four plans:

  • Free: $0. $1 of credits a month, 3 bots, 1 computer, 5 computer hours a month, 1 person, 1 GB of Library storage.
  • Plus: $15 a month or $150 a year. $5 of credits a month, 10 bots, 2 computers, 30 computer hours, 1 person, 10 GB.
  • Pro: $49 a month or $490 a year. $15 of credits a month, unlimited bots, 5 computers, 100 computer hours, 3 people, 50 GB.
  • Max: $99 a month or $899 a year. $30 of credits a month, unlimited bots, 10 computers, 300 computer hours, 10 people, 200 GB.

Plus, Pro and Max can also be paid by the week: $7.99, $19.99 and $39.99, with a quarter of the monthly credits each week.

Bigger plans also get bigger computers. Plans can change, so Settings → Billing always shows the current ones. See Pricing and Plans.

What do credits pay for?

On Casama Cloud, a credit is a dollar. Credits pay for the things that cost money each time a bot works: AI models, cloud computer time beyond your plan's hours, live calls, images and video, read-aloud and dictation, apps connected through Casama's own connector account, and paid data lookups, which always ask first and show the price.

A run that is waiting for your approval, or a computer that is asleep, costs nothing. A run that fails because of Casama or a model provider doesn't cost model credits. A self-hosted server uses no credits: you pay your providers directly.

Credits belong to the workspace. A month's included credits last until the end of the following month, and credit packs bought on the web and rewards last 12 months. Credit packs bought in the App Store or Google Play never expire. Credits that run out soonest are spent first. See Credits.

What happens when I run out of credits?

Bots stop starting new paid work and tell you why. Nothing is charged without you buying a credit pack or changing plan. On a paid plan you can buy packs of $10 or $25 of credits. On the Free plan, the paywall shows the paid plans.

Each plan also has a daily limit on what Casama Cloud spends for you in a day ($0.25 on Free, $5 on Plus, $10 on Pro and $25 on Max), which resets at midnight UTC, and a number of computer hours a month. When a workspace's balance drops under $1, its owners get a notification, at most once a week. See When a run hits a limit.

Can I limit what a bot spends?

Yes. Every bot has a budget per run ($1 by default) and per day ($10 by default). When a run reaches its budget it stops and tells you. The Usage screen shows spend by bot, by model, by day and by where the work came from, and Settings > Show usage on replies puts each reply's cost under it. See Bot budgets.

Is there a free trial?

Pro is free for 7 days, once per person, if you've never had a subscription. During the trial the workspace gets $2 of credits and 10 computer hours; the first payment tops the month up to $15.

Once per person means once per email inbox, so accounts on the same inbox share the trial, and deleting an account and signing up again doesn't start it over. See Plans.

Can I add people to my workspace?

Pro includes 3 people and Max includes 10. On the web, Pro and Max can add more people at $12 a month each ($120 a year). Free and Plus are for one person, the owner, so inviting someone needs Pro or Max. See Workspaces and teams.

Where do I pay?

It depends on where you use the app. On iPhone, iPad and the Mac App Store app you pay by in-app purchase, and in the US there's a web checkout link too. On Android you pay through Google Play. On the web, Windows, Linux and the Mac app from the web you use the web checkout.

Credit packs cost their face value on the web, and a little more in the App Store and Google Play, because the stores keep a share. Card details are handled by Apple, Google or Dodo Payments; Casama never sees your card number. See Where you can buy.

How do I cancel?

Open Settings → Billing and tap Manage Subscription. A subscription bought in a store is managed and cancelled in that store: on iPhone in Settings > Apple ID > Subscriptions, and on Android in Play Store > Payments & subscriptions.

Cancelling a store subscription keeps access until the end of the paid period. See Usage, budgets and plans.

Can I get a refund?

App Store purchases are refunded by Apple, at reportaproblem.apple.com. Google Play purchases are refunded by Google, under Play Store > Payments & subscriptions or on Google's refund request page. For purchases on the web or the desktop app, email billing@casama.ai.

A refund ends the plan for the period it paid for and takes back the credits that plan added that month. A refunded credit pack takes its credits back.

What happens if I downgrade?

Your workspace keeps everything: bots, chats, files and memories. Only the new plan's number of bots and cloud computers run or start, oldest first, and check-ins are limited to the plan's number of bots in the same way. See Usage, budgets and plans.

Account & data

Who can see my data?

On Casama Cloud, your chats, memories and files are used to run Casama for you. In a shared workspace, members see content according to their roles. Your About you details, the facts bots learn about you and your device data stay private to you. Every table uses row-level security, so one workspace can't read another's data, and workspace owners can encrypt content at rest.

On a self-hosted server, only people with access to your server can see your data, and Casama doesn't receive it. The server sends no telemetry unless its owner turns it on. The official apps connected to your server send only crash reports and one anonymous daily ping. See Privacy and security.

Is my data used to train AI models?

No. Your chats, memories and files are used to run Casama for you and for nothing else. We don't sell data or show ads, and your keys never reach the model.

To answer you, a bot sends the conversation and the context it needs to the model that runs it. Model providers have their own policies about the data they receive. A local model keeps it on your machine. See Privacy Policy.

Where is my data stored?

On Casama Cloud, the database and sign-in run on Casama's own servers, with Cloudflare for delivery, file storage and protection from attacks. Model requests go through OpenRouter, and live calls and read-aloud through Google. Casama is based in the Philippines, and some providers process data in other countries, including the United States. Encrypted backups are kept for 14 days.

On a self-hosted server, your data stays on your server. See Privacy Policy.

How do I export my data?

Open Settings → Privacy and tap Export My Data, or run casama account export. You get a ZIP of JSON files with everything you can see: bots, chats, memories, skills, routines, usage and more. Secrets and keys appear by name only.

The export doesn't include what bots made in the Library; open or download those from the Library. A single chat can be exported as Markdown or JSON. See Export your data.

How do I delete my account?

Open Settings → Privacy, and under Danger Zone tap Delete My Account, then type your email to confirm. You're signed out everywhere at once, and the app shows the date your data will be erased. On Casama Cloud that's after a 7-day grace period.

A workspace where you're the only owner is deleted with your account, even if other people use it. The app has no screen for making someone else an owner yet, so ask for help first if the workspace should stay. See Delete your account, and casama.ai/delete-account for deleting without the app.

Does the model see my passwords and API keys?

No. Secrets live in a vault and are filled in at the moment a tool uses them, inside the computer or the request. They're redacted from logs and never put into the model's input.

How do I keep my account secure?

Turn on two-step sign-in with an authenticator app, add a passkey to sign in with Face ID, a fingerprint or your screen lock, and turn on the app lock so Casama asks you to unlock it when it opens. With Confirm risky actions on (the default), Casama also asks you to unlock again before things like deleting your account or allowing a high-risk request. See Two-step sign-in.

Bots, apps & chat apps

Which models can I use?

On Casama Cloud, Casama picks and runs the models for you, so you don't need a key. Models are paid from your credits.

On your own server, use any model you have a key for: OpenAI, Anthropic, Google, xAI, OpenRouter, or any OpenAI-compatible endpoint (Ollama, vLLM, LM Studio and others). Each bot picks its own model, with fallbacks. See Bots and models.

Can I use my ChatGPT plan?

Yes, on a self-hosted server. In the desktop app, open Settings → Model keys and choose Continue with ChatGPT, or run casama credential chatgpt in the CLI. Bots' model calls then count toward your plan's limits, and only you can use it. Casama Cloud doesn't offer it. See Connect a ChatGPT plan.

Can I run it fully offline or with local models?

You can run the server on your own network and use a local model through an OpenAI-compatible endpoint, and calls to it are free. A local model can read pictures, and a local embedding model keeps memory search on your machine too. Bots that browse the web or use cloud apps still need internet access for those tasks. See Local models.

How do bots use my other apps?

Through connections. Open Settings → Integrations, pick an app from the catalog, and connect it with one sign-in or an API key. You can also add any MCP server, logins from a password manager such as 1Password or Bitwarden, and plugins.

Every connection is stored encrypted, and each bot gets only the connections you give it. See Apps and connections.

Can a bot answer me in WhatsApp, Telegram or iMessage?

Yes. A bot can answer in Telegram, email, SMS, Slack, WhatsApp, Messenger, Feishu, iMessage, Microsoft Teams and Discord, and every conversation also shows up in the Casama app. Assign it a Linear or Jira issue and it replies with a comment.

Each chat app is connected to one bot, and the bot answers only people on its Allowed senders list. iMessage needs your Mac to be on with the desktop app running. Group chats on WhatsApp and iMessage aren't supported, and approval buttons are in Telegram and Slack only. See Chat apps.

Does a bot join my meetings?

No. Casama doesn't send a bot into your calls. A bot can work from the notes your meeting app already takes, or from your calendar, and file a summary with decisions and action items. See Meeting notes.

Can a bot work on a schedule?

Yes. A routine is work a bot does later on its own: once at a time you pick, on a repeating schedule, or when something happens, such as a webhook, a meeting, a message or an event on your phone. The quickest way is to ask in chat, for example "Every weekday at 9:00, summarize my inbox". A routine can stop on a date or after a number of runs. See Routines.

Does each bot get its own computer?

Every bot works on a sandboxed Linux computer with a shell, a home folder that persists between chats and a browser that stays signed in. By default bots share the workspace's team computer, and you can give a bot a private computer of its own, optionally with a desktop you can watch live.

A computer goes to sleep after 5 minutes with nothing to do and wakes with everything intact, and an asleep computer costs nothing. On Casama Cloud, your plan sets how many computers you have and how many hours they can run each month. See Computers.

Can a bot use my own computer?

Yes, if you allow it. The desktop app for macOS, Windows and Linux can lend your machine to the bots you choose, to run commands and edit files in folders you share and use your desktop apps. Everything a bot does on your machine shows on screen and can be stopped, and nothing is allowed until you turn it on. See Your own computer.

Can I talk to a bot?

Yes. You can dictate messages, have replies read aloud, call a bot live, and let a bot ring your phone when something needs you. On Casama Cloud, voice is paid from your credits, with no keys to add. On your own server, voice uses your workspace's provider keys. See Voice and calls.

Safety

Can a bot do something I didn't want?

Every action has a risk level, and the bot's autonomy level decides which actions need your approval first. Risky steps such as sending, booking, paying or deleting wait for your OK by default. Action rules can allow an action (optionally within limits, such as recipients at one domain or a maximum amount), always ask, or hand it to you to finish.

You can also set budgets and stop a run at any time. Destructive commands take a checkpoint first (a recent one counts), so you can roll the computer back. Every run keeps a timeline of each step, what it cost and why. See Autonomy and approvals.

Can a bot spend my money without asking?

No. Payments always ask, whatever the bot's autonomy setting. Model and computer costs are capped by the bot's budgets. See How Casama keeps bots safe.

Does a bot follow instructions hidden in a web page?

Web pages, emails and files can contain text written to trick a bot. Casama marks that content as untrusted and tells the bot never to follow instructions inside it. After a bot has read untrusted content, actions that send data out ask for approval, even ones that normally wouldn't. See Untrusted content.

What stops a bot's computer from reaching my network?

Computers reach the internet only through an egress proxy that blocks private and cloud-metadata addresses, so a bot's computer can't reach your home or office network. Computers can't reach each other or Casama's internal services. See Computer providers.

What stops people from misusing Casama?

If a bot's reply is harmful, long-press it and choose Report reply. You can also report a bot, a gallery item or a person, and block people so they can't invite you. Reports go to the people who run the server, who can take content down or suspend a workspace.

Every public page and Library item has a link for viewers to report it, and after reports from three different people it's hidden until someone looks at it. A workspace can make at most 20 new public links a day. Casama Link addresses used for phishing or malware are taken down. See Report or block.

Self-hosting

Can I run it on my own server?

Yes. One command installs the whole stack with Docker on a Linux server, a home server or a Mac, or you can start it from the Mac and Linux app. Self-hosting is free, with no limit on users, bots or computers. See Self-hosting.

What do I need to self-host?

A Linux server (or a Mac, for a trial) with Docker, and a domain if other people will connect. Plan on 4 vCPU, 8 GB of RAM and 40 GB of disk for a few computers at once. See Self-hosting for sizing. To try it on your own Mac or Linux computer without a terminal, use Run on This Mac (or Run on This Computer) on the desktop app's sign-in screen. It walks you through Docker, the server, your account, a model and your phone.

How do I upgrade?

Re-run ./install.sh, or casama selfhost upgrade. Your settings and data are kept. See Operations.

Can I use a server on my own computer from my phone?

Yes. Casama Link gives a server installed with --local an address like https://k7qm2xfd9abc.casama.link, with no domain and no open ports. Your phone signs in by scanning a QR code, and notifications reach it like any other app's. Phone traffic goes through Cloudflare to your computer, never through Casama's servers. It's free on every plan, including Free. Watching a bot's computer live while you're away from home comes with Plus and up.

Can I use Casama Cloud computers from my own server?

Yes, with Casama Link. Computer time and model calls are paid from the cloud workspace's credits, and your bots, chats and data stay on your server. See Cloud computers and credits.

Can I move between Casama Cloud and my own server?

Yes. Your workspace exports in full, and bots, skills and routines can be shared as files and packs. See Templates, sharing and import.

Building on Casama

Is there an API?

Yes. Everything the apps do goes through a documented HTTP API, with a CLI and SDKs for TypeScript and Dart. See HTTP API and the API reference.

Can I extend what bots can do?

Yes: connect MCP servers, write plugins (skills plus tool servers), share whole bots and their routines as packs, share bot templates, or call other agents over A2A.

Can my coding agent learn Casama?

Yes. Give it the agent kit (skills for plugins, the API and more) and the docs MCP server, or point it at llms.txt. No account is needed. See Build with AI agents.

Can a bot hand work to a coding agent?

Yes. A bot can hand a coding task to a coding agent such as Claude Code, Codex or Cursor, and report back with a summary and the files that changed. The agent can run on your own computer with your own sign-ins, on the bot's computer, or as one of Cursor's cloud agents. See Coding agents.

How do I contribute?

Read Contribute to Casama, and How Casama is built for a map of the code. Bug reports, docs fixes and code are all welcome.

Getting help

How do I get help in the app?

Open Settings > Help & support. On Casama Cloud, Casama Help answers straight away: it knows these guides and can check your account and the workspace you have open: your plan and its limits, purchases, this month's usage, credit history, connected apps and chat channels, invites, and a bot's settings, routines and recent errors. It sees what the app would show you and never reads your chats. Answers can link straight to the screen or store page you need. When a person should take over, it writes up the problem and you send it to our support team with one tap; we reply by email. You can also choose Contact support there at any time.

The same page shows your support IDs. Your workspace ID is also your purchase ID in the App Store and Google Play, so share it if we ask about a purchase.

Is Casama Cloud down?

status.casama.ai shows whether the API, web app, sign-in and docs are working right now, with 90 days of uptime and a note when we know about a problem. It runs outside our servers, so it stays up when they don't. If the app can't reach Casama Cloud, the bar at the top has a Status button that opens it. For a self-hosted server, see Troubleshooting.

How do I reach the Casama team?
ForEmail
Anything else, or not surehello@casama.ai
Help with the apps or your accountsupport@casama.ai
Plans, invoices and refundsbilling@casama.ai
Your data and privacy requestsprivacy@casama.ai
Security issuessecurity@casama.ai (see SECURITY.md)

All of them are on the contact page.

Ask Casama Help

Casama Help answers from our docs and links the pages it used. It can't see your account.

Casama Help needs JavaScript. You can still email support@casama.ai.

Still stuck? Email support@casama.ai.

Signed up? Open Help & support in the app for account help.