computer README

The project's README from github.com/cloudflare/computer. As one markdown file: README.md.

Cloudflare Computer

Cloudflare Computer is a virtual filesystem that lives inside a Durable Object. The Durable Object holds the authoritative state in SQLite and exposes one pluggable execution surface through workspace.runtime. Three backends ship today:

A Workspace may register multiple backends under stable IDs. workspace.runtime.exec(source, { backend }) is the single execution entry point; the selected backend defines whether source is a shell command or an ECMAScript module. Backends connect lazily on first use.

Workspace can also be constructed without a backend at all, giving callers the filesystem on its own.

[!IMPORTANT] PREVIEW ONLY This package is provided as a preview for feedback only. APIs are unstable and the design is subject to change.

Suitable for experiments, exploration and prototypes. It is NOT suitable for production use at this time.

The specification under docs/ is forward-looking — read it for intent, not as description of the code today.

Using it

If you want to build on Cloudflare Computer, install @cloudflare/computer and follow that package's README — it has the installation steps, the entrypoint map, and worked examples of the fs and runtime surfaces.

To contribute feedback, see CONTRIBUTING.md. Approved collaborators should follow COLLABORATORS.md for setup, build, and test instructions.

Examples

The examples/ directory holds runnable consumers of the public surface. Each is a Worker workspace with its own README.

Repository layout

The repo is a small monorepo. Each package has its own README with package-specific status and usage notes.

Performance

computerd's FUSE mount beats real disk on metadata-heavy work and trails it on large sequential I/O. See docs/19_performance.md for the full fs-bench numbers, a cloudflare/sandbox-sdk npm install comparison, and how to reproduce them.

Documentation

Contributing

We accept bug reports, fix proposals, feature requests, and design proposals through issues and discussions. We do not accept unsolicited pull requests. See CONTRIBUTING.md for the public contribution paths.

Approved collaborators should follow COLLABORATORS.md for setup, formatting, testing, commit message, and pull request conventions.

If you're working in this repo as an agent, start with AGENTS.md and the skills under .agents/skills/.

License

MIT. See LICENSE.

computer (cloudflare/computer)

Searching Database…

Что это такое?Cloudflare Computer даёт ИИ-агенту постоянный компьютер: виртуальную файловую систему, которая хранится в SQLite-хранилище Durable Object, и подключаемые бэкенды, которые реально выполняют shell-команды или JavaScript над этой файловой системой.
Это отдельное приложение или то, на чём я сам что-то строю?Это монорепозиторий на TypeScript из npm-пакетов ('@cloudflare/computer', 'dofs', 'computerd', 'rpc'), который вы устанавливаете внутрь собственного Cloudflare Worker/Durable Object, а не отдельный сервис, который запускается сам по себе.
Как начать работу с этим?Установите пакет '@cloudflare/computer' и следуйте его README, где описаны шаги установки и API файловой системы и рантайма, или клонируйте один из готовых примеров, например 'examples/tutorial' или 'examples/mcp'.
Что нужно, чтобы это запустить?Нужен проект на Cloudflare Workers/Durable Objects; бэкенду Container дополнительно нужен контейнер-песочница с запущенным демоном computerd, который синхронизируется через RPC-канал capnweb.
Это уже готово для продакшена?Нет: в README прямо сказано, что это только превью-версия с нестабильными API. Она подходит для экспериментов и прототипов, но не для продакшена.
Какие три бэкенда выполнения?Container (песочница с настоящим FUSE-монтированием и полноценным пользовательским окружением Linux), Isolate shell (just-bash, работающий в Dynamic Worker) и Isolate JavaScript (модуль ECMAScript в Dynamic Worker). Все они запускаются через один и тот же вызов workspace.runtime.exec().
Может ли рабочее пространство использовать несколько бэкендов?Да, Workspace может регистрировать несколько бэкендов под стабильными ID, а для каждого вызова workspace.runtime.exec() вы выбираете, какой из них использовать.
Чем FUSE-монтирование по скорости отличается от настоящего диска?По данным fs-bench из docs/19performance.md, FUSE-монтирование computerd быстрее реального диска в операциях с большим количеством метаданных, но уступает ему в больших последовательных операциях ввода-вывода.
Что есть в папке examples?Готовые демонстрации: выполнение в контейнере и в worker-shell, политики исходящего трафика (egress), MCP-сервер инструментов, редуктор кода с длинным контекстом (rlm), терминальный чат-агент и публикация созданных проектов как Cloudflare Artifacts.
Creator
cloudflare
Size
8.9 MB
Stars
9.6K
Age
4mo
Commits · 90 Days