FAQ
General
How is Casama different from a chat assistant?
A chat assistant answers while you watch. A Casama bot keeps its own memory and computer, 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.
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 and three paid plans: Plus ($15 a month), Pro ($49) and Max ($99), each cheaper by the year. Models, computers and voice there are paid from credits, counted in dollars (1 credit = $1), and each plan adds credits every month. Pro has a 7-day free trial. See Usage, budgets and plans.
Which models can I 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.
On Casama Cloud, Casama picks the models, so you don't need a key.
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.
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. Bots that browse the web or use cloud apps still need internet access for those tasks.
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.
Privacy and safety
Who can see my data?
On a self-hosted server, only people with access to your server. Every table uses row-level security, so one workspace can't read another's data. Message content can be encrypted at rest. 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.
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.
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. 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, so you can roll the computer back. See Autonomy and approvals.
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. See Computer providers.
Self-hosting
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. Phone traffic goes through Cloudflare to your computer, never through Casama's servers. It's free on every plan, including Free.
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. 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 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.
Building on Casama
Is there an API?
Yes. Everything the apps do goes through a documented HTTP API. 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 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. See Build with AI 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.
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. 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?
| For | |
|---|---|
| Anything else, or not sure | hello@casama.ai |
| Help with the apps or your account | support@casama.ai |
| Plans, invoices and refunds | billing@casama.ai |
| Your data and privacy requests | privacy@casama.ai |
| Security issues | security@casama.ai (see SECURITY.md) |