Question 1

How do I allow network requests in Capsule tasks?

Accepted Answer

You must specify domains in the `allowed_hosts` parameter (e.g., `["api.openai.com"]`); by default, no outbound requests are permitted, and wildcards like `*` can allow all domains but reduce security.

Question 2

Capsule vs Docker for sandboxing AI agents?

Accepted Answer

Capsule uses lightweight WebAssembly sandboxes with finer-grained resource controls per task, whereas Docker offers broader OS-level isolation but heavier overhead; Capsule is better for task-level security within agent systems, but Docker is more versatile for full application containers.

Question 3

How to reduce startup latency for production use?

Accepted Answer

Pre-compile tasks with `capsule build --export` to generate `.wasm` files, then execute them directly via `capsule exec` or the SDK's `run` function, bypassing the compilation step and cutting initialization to milliseconds.

Question 4

Can I use machine learning libraries like TensorFlow in Capsule?

Accepted Answer

No, because TensorFlow relies on C/C++ extensions unsupported in the WebAssembly sandbox; the README notes that only pure Python or JavaScript packages without native bindings will work inside tasks.

Question 5

How to pass arguments to tasks from the CLI?

Accepted Answer

Arguments are forwarded via the `args` parameter in the `run()` function or CLI commands, and tasks access them as function parameters in the `main` task, as shown in the 'Run From Your Code' examples.

Question 6

What happens if a task exceeds its memory or CPU limits?

Accepted Answer

The task is terminated automatically: memory limits trigger out-of-memory errors, and CPU limits via fuel metering halt execution when fuel is exhausted, with errors captured in the structured JSON response.

Question 7

How to manage file access between multiple tasks?

Accepted Answer

Use the `allowed_files` configuration with read-only or read-write modes, or the `--mount` flag for dynamic directory aliases, but note that paths must stay within the project root and access is strictly allowlisted.

capsule

What is capsule?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions