# 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](https://docs.casama.ai/guide/library.md). 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](https://docs.casama.ai/self-hosting/remote-access.md), 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](https://docs.casama.ai/guide/usage.md).

### 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](https://docs.casama.ai/guide/bots.md).

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](https://docs.casama.ai/guide/meetings.md).

## 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](https://docs.casama.ai/guide/privacy.md).

### 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](https://docs.casama.ai/guide/autonomy.md).

### 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](https://docs.casama.ai/self-hosting/computers.md).

## Self-hosting

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

Yes. [Casama Link](https://docs.casama.ai/self-hosting/remote-access.md) 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](https://docs.casama.ai/self-hosting/index.md) 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](https://docs.casama.ai/self-hosting/operations.md).

### Can I use Casama Cloud computers from my own server?

Yes, with [Casama Link](https://docs.casama.ai/guide/casama-link.md). 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](https://docs.casama.ai/develop/api.md) and the
[API reference](https://docs.casama.ai/api/).

### Can I extend what bots can do?

Yes: connect MCP servers, write [plugins](https://docs.casama.ai/develop/plugins.md) (skills plus tool servers), share
[bot templates](https://docs.casama.ai/develop/bot-templates.md), or call other agents over [A2A](https://docs.casama.ai/develop/a2a.md).

### 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](https://docs.casama.ai/llms.txt). See [Build with AI agents](https://docs.casama.ai/develop/agents.md).

### How do I contribute?

Read [Contribute to Casama](https://docs.casama.ai/develop/contributing.md), and
[How Casama is built](https://docs.casama.ai/develop/architecture.md) 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](https://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](https://docs.casama.ai/self-hosting/troubleshooting.md).

### How do I reach the Casama team?

| For                              | Email                                         |
| -------------------------------- | --------------------------------------------- |
| Anything else, or not sure       | [hello@casama.ai](mailto:hello@casama.ai)       |
| Help with the apps or your account | [support@casama.ai](mailto:support@casama.ai) |
| Plans, invoices and refunds      | [billing@casama.ai](mailto:billing@casama.ai)   |
| Your data and privacy requests   | [privacy@casama.ai](mailto:privacy@casama.ai)   |
| Security issues                  | [security@casama.ai](mailto:security@casama.ai) (see `SECURITY.md`) |
