Skip to content
Back to search

casama

MarketplaceWorks with Claude CodeGitHub

Open-source AI teammates with their own computers. They remember, work while you're away and ask before anything risky. Self-host free with any model.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 20 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/stackwares/casama with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/stackwares/casama'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/stackwares--casama/badge.svg)](/listings/stackwares--casama)

HTML

<a href="/listings/stackwares--casama"><img src="/api/listings/stackwares--casama/badge.svg" alt="findsafeskills safety rating" /></a>

Install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 11 lines
  1. {
  2. "name": "casama",
  3. "owner": { "name": "Casama" },
  4. "plugins": [
  5. {
  6. "name": "casama-dev",
  7. "source": "./agent-kit",
  8. "description": "Skills and a docs MCP server that help coding agents build on Casama: plugins, the HTTP API, webhooks, A2A, bot templates, gallery items and the Casama repo."
  9. }
  10. ]
  11. }
README.md · README · 429 lines
  1. <p align="center">
  2. <img src="client/assets/bots/casama-winky-animated.svg" width="160" alt="Casama's cloud mascot, winking">
  3. </p>
  4. <h1 align="center">Casama</h1>
  5. <p align="center">
  6. <strong>Casama™: open-source AI teammates with their own computers.</strong><br>
  7. Bots that remember, reach out first, work on real computers, ask before risky steps, and run on any model.
  8. </p>
  9. <p align="center">
  10. <a href="https://app.casama.ai">Open the app</a> ·
  11. <a href="https://docs.casama.ai/quick-start">Quick start</a> ·
  12. <a href="https://docs.casama.ai/introduction">What is Casama</a> ·
  13. <a href="https://docs.casama.ai/self-hosting/">Self-hosting</a> ·
  14. <a href="https://docs.casama.ai/develop/api">Build on Casama</a> ·
  15. <a href="https://gallery.casama.ai">Gallery</a> ·
  16. <a href="https://docs.casama.ai">Docs</a>
  17. </p>
  18. <p align="center">
  19. <a href="LICENSING.md"><img src="https://img.shields.io/badge/license-AGPL--3.0-7a3fa8" alt="License: AGPL-3.0, SDKs Apache-2.0"></a>
  20. <a href="https://github.com/stackwares/casama/releases"><img src="https://img.shields.io/github/v/release/stackwares/casama?color=7a3fa8&include_prereleases" alt="Latest release"></a>
  21. <a href="https://status.casama.ai"><img src="https://img.shields.io/badge/status-status.casama.ai-7a3fa8" alt="Status"></a>
  22. <a href="https://github.com/sponsors/stackwares"><img src="https://img.shields.io/badge/sponsor-GitHub%20Sponsors-7a3fa8?logo=githubsponsors" alt="Sponsor Casama on GitHub"></a>
  23. <a href="https://www.opensourcealternatives.to"><img src="https://www.opensourcealternatives.to/badge-osa.svg" alt="As seen on Open Source Alternatives" height="20"></a>
  24. </p>
  25. <p align="center">
  26. <a href="https://discord.gg/e86XbXFHwz"><img src="https://img.shields.io/discord/1572818163685523536?label=Discord&logo=discord&logoColor=white&color=5865F2" alt="Join Casama on Discord"></a>
  27. <a href="https://x.com/CasamaAI"><img src="https://img.shields.io/badge/X-@CasamaAI-000000?logo=x" alt="Follow Casama on X"></a>
  28. <a href="https://bsky.app/profile/casama.ai"><img src="https://img.shields.io/badge/Bluesky-@casama.ai-0285FF?logo=bluesky&logoColor=white" alt="Follow Casama on Bluesky"></a>
  29. <a href="https://www.youtube.com/@casamaai"><img src="https://img.shields.io/badge/YouTube-@casamaai-FF0000?logo=youtube&logoColor=white" alt="Casama on YouTube"></a>
  30. <a href="https://www.facebook.com/casamaai"><img src="https://img.shields.io/badge/Facebook-casamaai-1877F2?logo=facebook&logoColor=white" alt="Casama on Facebook"></a>
  31. </p>
  32. ---
  33. ## What is Casama?
  34. Casama is an open-source app for AI teammates that each have their own computer, remember how you
  35. work and ask before anything risky. Its bots browse, fill in forms, write files and run code on a
  36. sandboxed Linux machine you can watch and take over, and they start work on schedules and triggers,
  37. so they keep going after you close the chat. It is for people and small teams who want an AI agent
  38. that does real work without setting it up in code. Casama is open source under AGPL-3.0 and free to
  39. self-host with any AI model, and it is also offered as Casama Cloud.
  40. ## Key facts
  41. - **License:** AGPL-3.0 for the product. The SDKs, CLI, MCP server and plugin kit are Apache-2.0.
  42. One optional folder, `ee/`, has its own license; Casama works fully without it. [LICENSING.md](LICENSING.md)
  43. - **Platforms:** native apps for iPhone, iPad, Android, Mac, Windows and Linux, plus the web, a
  44. command-line tool and an MCP server.
  45. - **Models:** any provider (OpenAI, Anthropic, Google, xAI, OpenRouter or any OpenAI-compatible
  46. endpoint), local models through Ollama, LM Studio or vLLM, or a ChatGPT plan when self-hosted.
  47. On Casama Cloud, Casama picks the models.
  48. - **Pricing:** free to self-host, with no paywall and no limits. Casama Cloud: Free, $15, $49 or
  49. $99 a month. [Pricing](https://casama.ai/pricing)
  50. - **Where it runs:** your own server, Mac or Linux computer (Docker and 8 GB of memory), or Casama Cloud.
  51. - **Status:** pre-1.0. Expect rough edges, and please [report them](https://github.com/stackwares/casama/issues).
  52. - **Made by:** Stackwares: Oliver Martinez (founder and CEO), Anna May A. Valdez (co-founder, product),
  53. April Dawn D. Martinez (customer success) and Kelly Avia Martinez (social and community). [About](https://casama.ai/about#who-makes-it)
  54. - **Links:** [casama.ai](https://casama.ai) · [docs](https://docs.casama.ai) ·
  55. [gallery](https://gallery.casama.ai) · [download](https://casama.ai/download) ·
  56. [web app](https://app.casama.ai)
  57. ## What a bot can do
  58. - **Work on a computer of its own.** Each bot has an isolated Linux computer with a shell, files and
  59. a browser. Watch it live, take control, or restore a checkpoint.
  60. - **Remember.** Bots keep memory you can read and edit, plus instructions, skills and knowledge sources.
  61. - **Work while you're away.** Schedules, webhooks, email, calendar events and check-ins start work
  62. without you, and a morning brief tells you what happened.
  63. - **Ask before risky steps.** By default a bot waits for your OK before sending email or chat
  64. messages, calling people, making a page public or deleting outside its workspace. Payments always
  65. ask. A checkpoint is saved before destructive commands.
  66. - **Meet you in your chat apps.** Telegram, email, SMS, Slack, WhatsApp, Messenger, Feishu,
  67. iMessage, Microsoft Teams and Discord.
  68. - **Connect to your tools.** One-click apps such as GitHub, Notion, Linear and Google, any MCP
  69. server, plugins, and an MCP server of its own so AI apps and coding tools can reach your bots.
  70. The full list is under [Features](#features).
  71. <p align="center">
  72. <a href="site/assets/film/casama-film-v7-16x9.mp4">
  73. <img src="docs/media/film-v7-poster.jpg" width="820" alt="Watch the Casama film: your AI assistant, with a computer of its own">
  74. </a>
  75. <br>
  76. <a href="site/assets/film/casama-film-v7-16x9.mp4">▶ Watch the film</a> (86 seconds, with sound)
  77. </p>
  78. <p align="center">
  79. <picture>
  80. <source media="(prefers-color-scheme: dark)" srcset="docs/media/screenshots/hero-dark.png">
  81. <img src="docs/media/screenshots/hero-light.png" alt="Casama on Mac and iPhone: Milo publishes Stardust Drift, a game he made, while his computer's live desktop plays it in the side panel">
  82. </picture>
  83. </p>
  84. ## How Casama compares
  85. | | License | Where it runs | A computer for the agent | Asks before risky steps | Choice of model | Chat apps | Price |
  86. | --- | --- | --- | --- | --- | --- | --- | --- |
  87. | **Casama** | AGPL-3.0 | Your own server, Mac or Linux computer, or Casama Cloud | Each bot has its own sandboxed Linux computer you can watch and take over | Yes, by default; a checkpoint is saved before destructive commands | Any provider, a ChatGPT plan or local models when self-hosted; Casama picks on Cloud | 10, including Slack, Teams, WhatsApp, Telegram and iMessage | Self-hosted: free. Cloud: Free, $15, $49 or $99 a month |
  88. | **OpenClaw** | MIT | Your own computer or server only; no hosted version | Runs on your machine; a sandbox is optional and off by default | Optional, and off by default | Your own keys, a ChatGPT or Claude plan, or local models | About 29, including WhatsApp, Telegram, Discord, Slack, Signal, iMessage and Teams | Free; you pay your model provider |
  89. | **Hermes Agent** | MIT | Your own computer or server; a hosted agent comes with paid Nous Portal plans | Your machine by default; Docker, SSH or cloud sandboxes are optional | For shell commands that match risky patterns | Your own keys, Nous Portal, some subscriptions, or local models | More than 20, including Telegram, Discord, Slack, WhatsApp, Signal, Teams and iMessage | Free; optional Nous Portal at $0, $20, $100 or $200 a month |
  90. | **Manus** | Closed | Manus's cloud; a desktop app can run commands on your computer | A cloud sandbox with a browser, per person | None described in the cloud; three modes on your own computer | Manus picks; no choice on standard plans | Slack and email | Free plan with 300 credits a day; Pro from $20 up to $200 a month; Team from $20 a seat |
  91. | **Grok Bot** | Closed | xAI's cloud only | One cloud computer per person, shared by all of that person's Bots | An automatic check decides; you can add up to 20 "ask first" rules | No choice, and you aren't shown which model ran | X, Slack, Microsoft Teams | $30, $100 or $200 a month; no free plan |
  92. | **Rakazo** | Apache-2.0 | Your own server, a desktop app, or Rakazo's cloud | Each bot has its own container or cloud computer | Yes: an Ask mode, or an Auto mode where a model decides when to ask | Your own keys, a ChatGPT plan, local models, or Rakazo credits at the provider's price | Slack and Teams; iMessage, WhatsApp and Telegram only when self-hosted | Self-hosted: free. Cloud: $15, $49 or $99 a month, or credits from $20 |
  93. | **Claude Cowork and Duet** | Closed | Anthropic's cloud; it reaches your computer through the desktop app | Cowork: cloud sessions you can watch. Duet: its own cloud computer that you can't watch | Cowork: depends on the mode you pick. Duet: asks before sending, paying, signing or deleting | Claude models only | The Claude apps only | Included in paid Claude plans and counted against their limits |
  94. Where others are ahead:
  95. - **OpenClaw** reaches about 29 chat apps, has no paid tier at all, is run by a nonprofit, and has
  96. the largest community of any project here.
  97. - **Hermes Agent** writes and refines its own skills, and lets you choose where commands run:
  98. locally, in Docker, over SSH or in a cloud sandbox.
  99. - **Manus** needs nothing set up and turns out finished slide decks, websites and wide research.
  100. - **Rakazo** charges for hosted model usage at the provider's price, with no markup.
  101. - **Claude Cowork** makes finished Word, Excel, PowerPoint and PDF documents from your own files.
  102. - **Casama** is the newest here, with a small community, and it has fewer chat apps than OpenClaw
  103. or Hermes Agent. On Casama Cloud you don't choose the model.
  104. Facts about other products were checked on November 18, 2026, against their own sites and docs.
  105. Every one has its source at [casama.ai/compare](https://casama.ai/compare), along with head-to-head
  106. pages such as [Casama vs OpenClaw](https://casama.ai/compare/casama-vs-openclaw) and
  107. [the best open-source AI agents](https://casama.ai/compare/best-open-source-ai-agents). We make
  108. Casama, so check the sources for anything that matters to you.
  109. ## Questions people ask
  110. ### Is Casama free?
  111. Yes, to self-host. The software is open source under AGPL-3.0, with no paywall, no limit on users or
  112. bots, and no license key. You pay only for the AI model you use, or nothing with a local model.
  113. Casama Cloud, the hosted service, has a free plan and paid plans at $15, $49 and $99 a month.
  114. ### Can I self-host Casama?
  115. Yes. On any machine with Docker and 8 GB of memory, clone this repository and run
  116. `./install.sh --local` for a trial, or `./install.sh --domain <your domain>` for a server. On a Mac
  117. or Linux computer, the desktop app's **Run on This Mac** (or **Run on This Computer**) sets it up for
  118. you. [Casama Link](#casama-link) lets your phone reach that server with no domain or open ports.
  119. ### Does Casama work with local models?
  120. Yes, on a self-hosted server. Point a bot at Ollama, LM Studio, vLLM or any server with an
  121. OpenAI-style API, and it runs for free on your own hardware. Local models that read pictures get
  122. them, and memory search can run on the same machine. Long, tool-heavy tasks still go better on the
  123. strongest hosted models.
  124. ### How is Casama different from OpenClaw?
  125. OpenClaw is one free, MIT-licensed agent that runs on your own computer, with about 29 chat apps;
  126. its sandbox and approval prompts are off until you turn them on. Casama is a team of bots, each on
  127. its own sandboxed Linux computer, that ask before risky steps from the start and can be shared in a
  128. workspace with roles. You can self-host Casama free or use Casama Cloud. OpenClaw has more chat apps
  129. and a much larger community. [Casama vs OpenClaw](https://casama.ai/compare/casama-vs-openclaw)
  130. ### Is it safe to let Casama use my email?
  131. Casama is built so mistakes are small and visible. By default a bot asks before sending email or
  132. chat messages, and payments always ask. Passwords and keys never reach the AI model: a bot uses a
  133. placeholder that Casama fills in only for the site that secret belongs to. Text in emails and web
  134. pages is treated as untrusted, and after a bot has read it, actions that send data out ask first.
  135. Budgets and a loop guard stop a run that goes wrong. [How Casama keeps bots safe](https://casama.ai/security)
  136. ### Does Casama train AI models on my data?
  137. No. Your chats, memories and files are used to run Casama for you and are not used to train AI
  138. models. On a self-hosted server they never leave your machine, apart from what you send to the model
  139. provider you chose.
  140. ## Try it
  141. On any machine with Docker and 8 GB of memory:
  142. ```sh
  143. git clone https://github.com/stackwares/casama && cd casama
  144. ./install.sh --local
  145. ```
  146. When it's up, open the Casama app on the same computer ([desktop](https://github.com/stackwares/casama/releases)
  147. or [web](https://app.casama.ai)), choose **Sign in or create account** → **More options** → **Server**,
  148. enter the address it prints, and create the first account. Add a model key or a local Ollama
  149. endpoint, and make your first bot. Running it on a server with a domain:
  150. [Self-host in about 15 minutes](#self-host-in-about-15-minutes).
  151. ## Two ways to run it
  152. | | Casama Cloud | Self-hosted |
  153. | --- | --- | --- |
  154. | **Start** | Sign up at [app.casama.ai](https://app.casama.ai) or in the apps | `./install.sh` on any machine with Docker ([below](#self-host-in-about-15-minutes)) |
  155. | **Models** | Casama picks them, paid from credits | Your own keys, a local model or your ChatGPT plan |
  156. | **Computers** | Run for you | Run on your server, or borrowed from Cloud through [Casama Link](#casama-link) |
  157. | **Price** | Free plan, then paid plans ([below](#casama-cloud)) | Free, with no paywall and no limits |
  158. Both use the same apps, CLI and API.
  159. ## Features
  160. - **Persistent bots**: instructions, memory, [skills](docs-site/guide/skills.md),
  161. [knowledge sources](docs-site/guide/memory.md) and budgets, with personas, starter bots and a
  162. setup interview where the bot proposes its own setup. [Bots and models](docs-site/guide/bots.md)
  163. - **One conversation, many topics**: each bot has a General chat for quick questions, briefs and
  164. results, and bigger work runs in topics that report back.
  165. [Chatting with a bot](docs-site/guide/chat.md)
  166. - **Bots that reach out first**: a morning brief, and suggestions with Do It and Not Now buttons
  167. when a bot spots something in your mail or calendar it could handle. Quiet hours are on by
  168. default. [Check-ins](docs-site/guide/routines.md#check-ins)
  169. - **A real computer each**: an isolated Linux computer that sleeps when idle. Watch it live, take
  170. control, restore checkpoints, or lend your own machine through the desktop app.
  171. [Computers](docs-site/guide/computers.md)
  172. - **Teach by showing**: do a task once on the bot's computer while Casama records it, and the bot
  173. turns the recording into a skill it can repeat. [Teach by showing](docs-site/guide/teach.md)
  174. - **The Library**: sites and games, reports, documents, pictures, videos and sounds a bot makes are
  175. kept with versions, grouped by [project](docs-site/guide/projects.md), and shareable with a link.
  176. Replies can carry buttons, forms, maps, video and audio the app draws natively.
  177. [The Library](docs-site/guide/library.md) · [Pages](docs-site/guide/pages.md)
  178. - **Works while you're away**: schedules, webhooks, calendar, message and device triggers, watchers,
  179. and routines that end on a date or after a number of runs.
  180. [Routines](docs-site/guide/routines.md) · [Meeting notes](docs-site/guide/meetings.md)
  181. - **Bots working together**: bots split up work, hand tasks to each other, manage other bots, hand
  182. coding to Claude Code, Codex, Cursor, Pi or T3 Code and come back with the pull request, and
  183. talk to bots outside your workspace over A2A.
  184. [Bots working together](docs-site/guide/bots-together.md) ·
  185. [Coding agents](docs-site/guide/coding-agents.md)
  186. - **You stay in charge**: autonomy levels, approvals, action rules, budgets, a loop guard and a full
  187. timeline of every run. Bots can even pay for things with a single-use card you approve each time.
  188. [Autonomy](docs-site/guide/autonomy.md) · [Payments](docs-site/guide/payments.md)
  189. - **Any model**: OpenAI, Anthropic, Google, xAI, OpenRouter or any OpenAI-compatible endpoint,
  190. including free local models through Ollama, LM Studio or vLLM. Local models that read pictures
  191. get them, and memory search can run on the same machine. Self-hosters can sign in with a ChatGPT
  192. plan. On Casama Cloud, Casama picks the models. [Bots and models](docs-site/guide/bots.md)
  193. - **Connected to your tools**: one-click apps (GitHub, Notion, Linear, Google and more), meeting
  194. notes apps, MCP servers, plugins, password managers and device data, with secrets kept out of the
  195. model's sight. Phone and computer data (calendar, contacts, health summaries) too, when you allow it.
  196. [Connections](docs-site/guide/connections.md) · [Devices](docs-site/guide/devices.md)
  197. - **Where you already work**: Slack (with approval buttons in the thread), Microsoft Teams, Discord,
  198. Telegram, WhatsApp, Messenger, Feishu, iMessage, email and SMS; assign a bot a Linear or Jira
  199. issue; group chats with several bots.
  200. [Chat apps](docs-site/guide/chat-apps.md) · [Group chats](docs-site/guide/group-chats.md)
  201. - **Voice and calls**: dictate, have replies read aloud, call a bot live or let it ring your phone.
  202. Minimise a call and keep using the app; it carries on when you lock the phone, and you can watch
  203. the bot's computer during the call. [Voice and calls](docs-site/guide/voice.md)
  204. - **Sites at their own address**: publish a site a bot made in one tap, at a free address on
  205. Casama's sites domain or on your own domain. On Casama Cloud you can buy a domain in the app, with
  206. the DNS set up for you, and it renews itself. [Sites and domains](docs-site/guide/sites-and-domains.md)
  207. - **Never more than a glance away** *(coming soon)*: a working bot shows in your Mac's notch and
  208. menu bar (the tray on Windows and Linux), and on your phone's Lock Screen as a Live Activity or
  209. Android live notification, with Stop, Allow and Deny right there. Casama for Chrome, Edge and
  210. Firefox asks a bot about the page you're on and saves things to your Library. A push tells you
  211. when a reply is ready, with a switch for each kind of notification.
  212. [Notch and menu bar](docs-site/guide/notch.md) · [Lock Screen](docs-site/guide/lock-screen.md) ·
  213. [Casama for Chrome](docs-site/guide/chrome.md) · [Notifications](docs-site/guide/attention.md)
  214. - **Teams and sharing**: workspaces with roles and invites, bots shared with teammates or passed on
  215. as templates anyone can import. [Workspaces](docs-site/guide/workspaces.md) ·
  216. [Sharing](docs-site/guide/sharing.md)
  217. - **Your server on your phone**: [Casama Link](#casama-link) gives a server on your own computer a
  218. `casama.link` address your phone signs in to by scanning a QR code. Free on every plan.
  219. - **An open gallery**: themes, skills, apps, starter bots, routine ideas, starter sets and plugins
  220. at [gallery.casama.ai](https://gallery.casama.ai). Each item says what it can reach, the catalog is
  221. signed, installs update in place, and workspace admins can require approval. Anyone can add to it
  222. with a pull request or straight from the app, and every app picks it up without a release.
  223. [Gallery](gallery/README.md)
  224. - **Built to build on**: an HTTP API, a CLI, TypeScript and Dart SDKs, an MCP server for AI apps,
  225. plugins, bot templates and agent-to-agent (A2A). Coding agents get an
  226. [agent kit](agent-kit/) of skills and a docs MCP server. [Build on Casama](docs-site/develop/agents.md)
  227. - **Private by design**: row-level security on every table, encryption at rest with replaceable keys,
  228. data export and deletion. A self-hosted server sends no telemetry unless you turn it on.
  229. [Privacy](docs-site/guide/privacy.md)
  230. ### See it
  231. <p align="center">
  232. <picture>
  233. <source media="(prefers-color-scheme: dark)" srcset="docs/media/screenshots/mac-group-dark.png">
  234. <img src="docs/media/screenshots/mac-group-light.png" alt="A group chat on Mac: you ask @everyone to plan Sam's birthday, Nova hands the invite to Ada and the RSVP page to Milo, and Ada's invite comes back">
  235. </picture>
  236. </p>
  237. <p align="center">
  238. <picture>
  239. <source media="(prefers-color-scheme: dark)" srcset="docs/media/screenshots/mac-nova-dark.png">
  240. <img src="docs/media/screenshots/mac-nova-light.png" alt="Casama on Mac: Nova plans a weekend in Kyoto and shows each day's stops on a map in the chat">
  241. </picture>
  242. </p>
  243. <p align="center">
  244. <picture>
  245. <source media="(prefers-color-scheme: dark)" srcset="docs/media/screenshots/iphone-dark.png">
  246. <img src="docs/media/screenshots/iphone-light.png" alt="Casama on iPhone: your bots with their mascots, Nova's Kyoto plan on a map, Milo's bakery site, and Juno ready to start">
  247. </picture>
  248. </p>
  249. <p align="center">
  250. <picture>
  251. <source media="(prefers-color-scheme: dark)" srcset="docs/media/screenshots/ipad-dark.png">
  252. <img src="docs/media/screenshots/ipad-light.png" alt="Casama on iPad: Milo plays Stardust Drift, a game he made, live on his own computer while you watch">
  253. </picture>
  254. </p>
  255. ## Self-host in about 15 minutes
  256. You need a machine with Docker.
  257. ```sh
  258. git clone https://github.com/stackwares/casama && cd casama
  259. ./install.sh --local # a trial on this machine
  260. ./install.sh --domain casama.example.com # or a server with a domain pointed at it
  261. ```
  262. Then open the app, tap **Let's Go** → **More Options**, enter your server's address, and create the
  263. first account, which becomes the server's owner. Add a model key, a local model or your ChatGPT
  264. plan under **Settings** → **Model keys**. On a Mac or Linux, the desktop app can also do all of
  265. this for you: **Run on This Mac** (or **Run on This Computer**) on the sign-in screen walks through
  266. Docker, the server, your account, a model and your phone (it needs Docker and about 10 GB of disk).
  267. To use that server from your phone, turn on [Casama Link](#casama-link). The full guide covers requirements, configuration, upgrades
  268. and backups: [Self-hosting](docs-site/self-hosting/index.md).
  269. ## Casama Cloud
  270. [Casama Cloud](https://casama.ai) is the hosted service, for when you'd rather not run a server.
  271. Sign up at [app.casama.ai](https://app.casama.ai) or in the apps. Casama picks the models and runs
  272. the computers, and each plan includes monthly credits for models, computers and voice. You can buy
  273. more credits or add your own model keys.
  274. | Plan | Price | Credits a month | Bots | Computer hours a month | People |
  275. | --- | --- | --- | --- | --- | --- |
  276. | **Free** | $0 | $1 | 3 | 5 | 1 |
  277. | **Plus** | $15 a month | $5 | 10 | 30 | 1 |
  278. | **Pro** | $49 a month (7-day free trial) | $15 | Unlimited | 100 | 3 (+$12 each) |
  279. | **Max** | $99 a month ($899 a year) | $30 | Unlimited | 300 | 10 (+$12 each) |
  280. Self-hosting needs none of this. Plans can change, so the app's **Billing** screen and
  281. [Usage, budgets and plans](docs-site/guide/usage.md) always have the current ones.
  282. ## Casama Link
  283. [Casama Link](docs-site/guide/casama-link.md) connects a server you run yourself to Casama Cloud.
  284. Your bots, chats, memory and files stay on your server. It has two parts, and you can use either
  285. one or both:
  286. - **Remote access (free on every plan):** your server gets an address like
  287. `https://k7qm2xfd9abc.casama.link` that your phone can reach, with no domain and no open ports.
  288. Sign in by scanning a QR code, and get notifications in the App Store and Google Play apps. Run
  289. `casama selfhost remote on`, or open **Settings** → **Casama Link** in the desktop app.
  290. [Use your server on your phone](docs-site/self-hosting/remote-access.md)
  291. - **Cloud computers and credits (paid):** your server's bots run on Casama Cloud's computers or pay
  292. for model calls from Cloud credits, for when you don't want to host computers or manage keys, or
  293. your platform has no Docker. [Cloud computers and credits](docs-site/self-hosting/casama-link-cloud.md)
  294. ## Platforms
  295. | Where | How |
  296. | --- | --- |
  297. | iOS, iPadOS, Android, macOS, Windows and Linux | The Flutter app in [`client`](client) |
  298. | The web | The same app at [app.casama.ai](https://app.casama.ai), or served by your own server |
  299. | Your browser *(coming soon)* | Casama for Chrome, Edge and Firefox, in [`apps/extension`](apps/extension). [Casama for Chrome](docs-site/guide/chrome.md) |
  300. | The terminal | The `casama` CLI: `brew install stackwares/tap/casama`, or a binary from [Releases](https://github.com/stackwares/casama/releases). [CLI](docs-site/develop/cli.md) |
  301. | AI apps and coding tools | The Casama MCP server. [Connect AI apps](docs-site/guide/mcp.md) |
  302. | Your own software | The [HTTP API](docs-site/develop/api.md), the [TypeScript client](docs-site/develop/typescript.md) and the [Dart SDK](docs-site/develop/sdk.md) |
  303. | Coding agents | The [agent kit](agent-kit/): skills, a docs MCP server and `casama init`. [Build with AI agents](docs-site/develop/agents.md) |
  304. ## Documentation
  305. The documentation is at [docs.casama.ai](https://docs.casama.ai). Its source is in
  306. [`docs-site/`](docs-site/) (a VitePress site; `pnpm --filter @casama/docs dev` serves it locally).
  307. | | |
  308. | ------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  309. | **Get started** | [What is Casama](docs-site/introduction.md) · [Quick start](docs-site/quick-start.md) · [FAQ](docs-site/faq.md) |
  310. | **Guides** | [Bots](docs-site/guide/bots.md) · [Chat](docs-site/guide/chat.md) · [Library](docs-site/guide/library.md) · [Projects](docs-site/guide/projects.md) · [Sites and domains](docs-site/guide/sites-and-domains.md) · [Computers](docs-site/guide/computers.md) · [Routines](docs-site/guide/routines.md) · [Connections](docs-site/guide/connections.md) · [Voice and calls](docs-site/guide/voice.md) · [Notifications](docs-site/guide/attention.md) · [Notch and menu bar](docs-site/guide/notch.md) · [Lock Screen](docs-site/guide/lock-screen.md) · [Casama for Chrome](docs-site/guide/chrome.md) · [Casama Link](docs-site/guide/casama-link.md) · [Autonomy](docs-site/guide/autonomy.md) · [Workspaces](docs-site/guide/workspaces.md) |
  311. | **Self-hosting** | [Install](docs-site/self-hosting/index.md) · [Configuration](docs-site/self-hosting/configuration.md) · [Use it on your phone](docs-site/self-hosting/remote-access.md) · [Operations](docs-site/self-hosting/operations.md) · [Troubleshooting](docs-site/self-hosting/troubleshooting.md) |
  312. | **Build on Casama** | [Build with AI agents](docs-site/develop/agents.md) · [HTTP API](docs-site/develop/api.md) · [CLI](docs-site/develop/cli.md) · [TypeScript](docs-site/develop/typescript.md) · [Dart SDK](docs-site/develop/sdk.md) · [Plugins](docs-site/develop/plugins.md) · [Webhooks](docs-site/develop/webhooks.md) |
  313. | **Contributors** | [How Casama is built](docs-site/develop/architecture.md) · [Contribute](docs-site/develop/contributing.md) · [Decision log](docs/DECISIONS.md) · [Product spec](SPEC.md) |
  314. ## Architecture
  315. A TypeScript API and worker (one codebase) on Postgres with row-level security, a sandbox
  316. supervisor that alone talks to Docker, one container per bot computer behind an egress proxy, and a
  317. Flutter app for every platform. [How Casama is built](docs-site/develop/architecture.md) maps the
  318. repository and follows one message from the app to a computer and back.
  319. ## Contributing
  320. Contributions are welcome, from typo fixes to features. [CONTRIBUTING.md](CONTRIBUTING.md) explains
  321. the development setup, the checks and how to send a change. Every commit needs a
  322. [DCO](https://developercertificate.org/) sign-off (`git commit -s`), and every contributor signs the
  323. one-time [CLA](CLA.md). Please follow the
  324. [Code of Conduct](CODE_OF_CONDUCT.md). How decisions are made is in [GOVERNANCE.md](GOVERNANCE.md).
  325. - **Questions and ideas**: [GitHub Discussions](https://github.com/stackwares/casama/discussions)
  326. - **Bugs and feature requests**: [GitHub Issues](https://github.com/stackwares/casama/issues)
  327. ## Sponsors
  328. Casama is free to self-host, with no limit on users or bots. If you run it yourself, at home or at
  329. work, you can help keep it that way through
  330. **[GitHub Sponsors](https://github.com/sponsors/stackwares)**, from $5 a month or one time.
  331. Sponsorships pay for releases on every platform, security fixes, plugin reviews and docs.
  332. Sponsors at $25 and up are listed here, and teams at $100 and up on
  333. [casama.ai/open-source](https://casama.ai/open-source). Using [Casama Cloud](https://casama.ai/pricing)
  334. pays for the project too.
  335. <!-- sponsors -->
  336. Be the first: [become a sponsor](https://github.com/sponsors/stackwares).
  337. <!-- /sponsors -->
  338. ## Security
  339. Please report vulnerabilities privately to **security@casama.ai** or through GitHub's private
  340. vulnerability reporting, never in a public issue. [SECURITY.md](SECURITY.md) explains what's in
  341. scope and what to expect.
  342. ## License
  343. The product (server, worker, agent and the apps) is under [AGPL-3.0](LICENSE). The SDKs, CLI, MCP
  344. server, plugin kit, examples and docs are under [Apache-2.0](LICENSES/Apache-2.0.txt), so whatever
  345. you build on Casama can use any license. `ee/` is source-available under the
  346. [Casama Enterprise License](ee/LICENSE) and needs a license key in production. Without `ee/`,
  347. Casama is fully open source and works on its own. A
  348. commercial license is available for organisations that can't use AGPL (hello@casama.ai).
  349. [LICENSING.md](LICENSING.md) explains the split; see also [NOTICE](NOTICE),
  350. [TRADEMARKS.md](TRADEMARKS.md), [CLA.md](CLA.md) and [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
  351. **Casama™**, the Casama logo and the bot mascots are trademarks of Stackwares. The license covers the
  352. code, not the name: forks are welcome under their own name ([TRADEMARKS.md](TRADEMARKS.md)).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.