Cloudflare Computer: Give Your Agent a Virtual Filesystem

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.

Use at your own risk

OSRepos shares public repositories for knowledge and discovery only. Any installation, execution, configuration, or use of code from these repositories is the user's own responsibility. Always review the repository, source code, dependencies, licenses, and security implications before running or installing anything. OSRepos is not responsible for issues, damages, or losses resulting from third-party repositories.

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

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