Build
Manifest reference
The floom.yaml lives at the root of your app directory. Only slug is required.
All fields#
floom.yaml: all fields
slug: my-app
# The command to run. Auto-detected from app.py / index.js if omitted.
command: python app.py
# Relative path to a JSON Schema file for inputs (optional but recommended).
input_schema: ./input.schema.json
# Relative path to a JSON Schema file for outputs (optional).
output_schema: ./output.schema.json
# Make the app publicly runnable without auth.
public: true
# Secret names to inject as env vars at run time. Values are set separately.
secrets:
- GEMINI_API_KEY
- OPENAI_API_KEY
# Optional: additional pip deps installed before the run command.
# dependencies:
# python: ./requirements.txt --require-hashes
# Optional: paths to skip when building the bundle.
# bundle_exclude:
# - fixtures/large-dataset.csv| Field | Required | Description |
|---|---|---|
| slug | Yes | URL-safe identifier. Used in /p/:slug, API, and MCP calls. |
| name | No | Display name shown in the browser UI and app cards. Defaults to slug if omitted. |
| command | No | Shell command to run the app. Auto-detected from app.py or index.js if omitted. |
| input_schema | No | Relative path to a JSON Schema file. Floom validates inputs before running. |
| output_schema | No | Relative path to a JSON Schema file. Floom validates stdout output against this. |
| public | No | true = anyone can run without auth. Default: false. |
| secrets | No | List of secret names. Values set via CLI or REST, injected as env vars at run time. |
| dependencies.python | No | Path to requirements.txt, optionally with --require-hashes. |
| bundle_exclude | No | List of paths/globs to skip when building the bundle. |
Legacy v0.1 format#
Manifests using runtime, entrypoint, and handler still deploy and run unchanged. No migration needed.
Legacy format (still supported)
# Legacy v0.1 shape — still works, no migration needed
name: Meeting Action Items
slug: meeting-action-items
runtime: python
entrypoint: app.py
handler: run
public: true
input_schema: ./input.schema.json
output_schema: ./output.schema.json
dependencies:
python: ./requirements.txt