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.