{"name":"Cloudflare Computer: Give Your Agent a Virtual Filesystem","description":"Cloudflare Computer is an innovative project that provides a virtual filesystem within a Durable Object, allowing agents to interact with a persistent state. It offers pluggable execution backends, including containerized Linux environments and serverless Workers, enabling flexible and powerful agent computing. Currently in preview, it's ideal for experiments and prototypes leveraging Cloudflare's edge infrastructure.","github":"https://github.com/cloudflare/computer","url":"https://osrepos.com/repo/cloudflare-computer","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/cloudflare-computer","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/cloudflare-computer.md","json":"https://osrepos.com/repo/cloudflare-computer.json","topics":["TypeScript","Cloudflare","Durable Objects","Workers","Virtual Filesystem","Agent Computing","Serverless","FUSE"],"keywords":["TypeScript","Cloudflare","Durable Objects","Workers","Virtual Filesystem","Agent Computing","Serverless","FUSE"],"stars":null,"summary":"Cloudflare Computer is an innovative project that provides a virtual filesystem within a Durable Object, allowing agents to interact with a persistent state. It offers pluggable execution backends, including containerized Linux environments and serverless Workers, enabling flexible and powerful agent computing. Currently in preview, it's ideal for experiments and prototypes leveraging Cloudflare's edge infrastructure.","content":"## Introduction\n\nCloudflare Computer is an innovative project designed to provide a virtual filesystem within a Cloudflare Durable Object. This system maintains its authoritative state in SQLite, offering a persistent and reliable storage solution. A key feature is its pluggable execution surface, `workspace.runtime`, which allows for diverse computing environments.\n\nIt currently ships with three distinct backends:\n*   **Container**: Projects the SQLite state into a sandbox container as a real FUSE mount, providing a full Linux userland with real binaries and network access.\n*   **Isolate shell**: Runs [just-bash](https://github.com/vercel-labs/just-bash){target=\"_blank\"} in a Dynamic Worker, interacting with the authoritative Workspace over Workers RPC.\n*   **Isolate JavaScript**: Executes an ECMAScript module in a fresh Dynamic Worker, complete with structured input/results and Workspace-backed filesystem capabilities.\n\nPlease note, Cloudflare Computer is currently in **PREVIEW ONLY**. Its APIs are unstable, and the design is subject to change. It is suitable for experiments, exploration, and prototypes, but not yet for production use.\n\n## Installation\n\nTo begin building with Cloudflare Computer, you can install the core package:\n\nbash\nnpm install @cloudflare/computer\n\n\nFor detailed installation steps, entrypoint maps, and worked examples of the `fs` and `runtime` surfaces, please refer to the README of the `@cloudflare/computer` package within the repository.\n\n## Examples\n\nThe repository includes an `examples/` directory, showcasing various ways to utilize Cloudflare Computer. Each example is a Worker workspace with its own README:\n\n*   **Container**: Demonstrates running `computerd` inside a container, mounting a workspace, and communicating with a Durable Object over capnweb.\n*   **Worker Shell**: Shows a similar HTTP surface to the container example, but the shell runs [just-bash](https://github.com/vercel-labs/just-bash){target=\"_blank\"} in a Dynamic Worker.\n*   **Worker JavaScript**: Mirrors the `worker-shell` example, but executes an ECMAScript module in a Dynamic Worker instead of a shell command.\n*   **Think**: An example of a [`@cloudflare/think`](https://www.npmjs.com/package/@cloudflare/think){target=\"_blank\"} chat agent that uses the workspace as its working directory.\n*   **Tutorial**: A step-by-step guide building an agent that writes a markdown recipe card and converts it to a PDF using `pandoc` in a container.\n*   **Artifacts**: Generates a Worker project within a workspace and publishes it to Cloudflare Artifacts.\n*   **Assets**: Turns a prompt into an image using Workers AI, writes it to the workspace, and returns a shareable link.\n\n## Why Use It\n\nCloudflare Computer offers a unique platform for developing intelligent agents and serverless applications that require persistent state and flexible execution environments. By combining a virtual filesystem with Cloudflare's Durable Objects and Workers, it enables developers to:\n\n*   Provide agents with a \"working directory\" that persists across invocations.\n*   Execute code in diverse environments, from full Linux containers to lightweight JavaScript or shell Workers.\n*   Leverage Cloudflare's global network for low-latency, scalable operations.\n*   Experiment with advanced agent architectures and serverless computing patterns.\n\n## Links\n\n*   **GitHub Repository**: [https://github.com/cloudflare/computer](https://github.com/cloudflare/computer){target=\"_blank\"}\n*   **License**: [https://github.com/cloudflare/computer/blob/main/LICENSE](https://github.com/cloudflare/computer/blob/main/LICENSE){target=\"_blank\"}\n*   **Documentation**: [https://github.com/cloudflare/computer/tree/main/docs](https://github.com/cloudflare/computer/tree/main/docs){target=\"_blank\"}","metrics":{"detailViews":2,"githubClicks":2},"dates":{"published":null,"modified":"2026-08-14T15:01:33.000Z"}}