FAQ

Reference

FAQ

Common questions about building and running Floom apps.

Why does my app fail with 'command not found'?

The sandbox starts with a stock E2B image. If your app needs a system package (ffmpeg, pandoc, etc.), install it at the top of your run command: command: bash -c 'apt-get install -y ffmpeg -q && python app.py'.

How do I update an app?

Run floom deploy again from the same directory. Floom creates a new bundle version. The slug stays the same; in-flight runs complete on the old bundle.

How do I delete an app?

DELETE /api/apps/:slug with an agent token that has publish scope. There is no CLI shortcut yet.

Can I run JavaScript or TypeScript?

Yes. Add a package.json with a start script and Floom runs npm install && npm start. TypeScript needs a compile step; add it to the start script or use ts-node.

Is my app code private?

Apps with public: false are private. The bundle is stored with owner-only access. Public apps have their source viewable at /p/:slug.

Can I pass a file as input?

Use x-floom-format: file on a string field in your input schema. The browser UI shows a file picker. The file is base64-encoded and sent as the field value.

My Gemini key is hitting quota. What should I do?

Add your own GEMINI_API_KEY as a secret and use it in your app. The free Gemini tier allows roughly 15 requests per minute; upgrade to a paid key for higher throughput.

Something looks wrong rather than just confusing? See the troubleshooting guide for step-by-step fixes for common broken states.

Last updated: 2026-05-04 · Floom v0.4