# Cloudflare Computer: Give Your Agent a Virtual Filesystem

This repository profile is provided by osrepos.com, an open source repository discovery platform.

Source: osrepos.com
Repository profile: https://osrepos.com/repo/cloudflare-computer
Generated for open source discovery and AI-assisted research.

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
OSRepos URL: https://osrepos.com/repo/cloudflare-computer

## 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.

## Topics

- TypeScript
- Cloudflare
- Durable Objects
- Workers
- Virtual Filesystem
- Agent Computing
- Serverless
- FUSE

## Repository Information

Last analyzed by OSRepos: Fri Aug 14 2026 16:01:33 GMT+0100 (Western European Summer Time)
Detail views: 2
GitHub clicks: 2

## Safety Notice

OSRepos shares public repositories for knowledge and discovery only. Review source code, dependencies, licenses, and security implications before running or installing anything.

## Content

## Introduction

Cloudflare 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.

It currently ships with three distinct backends:
*   **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.
*   **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.
*   **Isolate JavaScript**: Executes an ECMAScript module in a fresh Dynamic Worker, complete with structured input/results and Workspace-backed filesystem capabilities.

Please 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.

## Installation

To begin building with Cloudflare Computer, you can install the core package:

bash
npm install @cloudflare/computer


For 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.

## Examples

The repository includes an `examples/` directory, showcasing various ways to utilize Cloudflare Computer. Each example is a Worker workspace with its own README:

*   **Container**: Demonstrates running `computerd` inside a container, mounting a workspace, and communicating with a Durable Object over capnweb.
*   **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.
*   **Worker JavaScript**: Mirrors the `worker-shell` example, but executes an ECMAScript module in a Dynamic Worker instead of a shell command.
*   **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.
*   **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.
*   **Artifacts**: Generates a Worker project within a workspace and publishes it to Cloudflare Artifacts.
*   **Assets**: Turns a prompt into an image using Workers AI, writes it to the workspace, and returns a shareable link.

## Why Use It

Cloudflare 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:

*   Provide agents with a "working directory" that persists across invocations.
*   Execute code in diverse environments, from full Linux containers to lightweight JavaScript or shell Workers.
*   Leverage Cloudflare's global network for low-latency, scalable operations.
*   Experiment with advanced agent architectures and serverless computing patterns.

## Links

*   **GitHub Repository**: [https://github.com/cloudflare/computer](https://github.com/cloudflare/computer){target="_blank"}
*   **License**: [https://github.com/cloudflare/computer/blob/main/LICENSE](https://github.com/cloudflare/computer/blob/main/LICENSE){target="_blank"}
*   **Documentation**: [https://github.com/cloudflare/computer/tree/main/docs](https://github.com/cloudflare/computer/tree/main/docs){target="_blank"}