{
  "manifest_version": "1",
  "slug": "streamlit",
  "title": "Streamlit",
  "headline": "Deploy a Streamlit app",
  "description": "Deploy a Streamlit or Gradio app to an exe.dev VM: private behind exe.dev login, git push to deploy, data on a real disk, and LLMs with no API key.",
  "category": "frameworks",
  "tags": [
    "streamlit",
    "gradio",
    "python",
    "data apps",
    "dashboards",
    "uv",
    "git push deploy",
    "streamlit community cloud alternative",
    "hugging face spaces alternative"
  ],
  "url": "https://exe.dev/deploy/streamlit",
  "markdown_url": "https://exe-staging.dev/deploy/streamlit.md",
  "upstream": {
    "website": "https://streamlit.io",
    "source": "https://github.com/streamlit/streamlit",
    "docs": "https://docs.streamlit.io/deploy",
    "license": "Apache-2.0"
  },
  "example_vm_name": "my-streamlit",
  "time": "10 minutes",
  "stack": [
    {
      "name": "Your Streamlit app",
      "detail": "`streamlit run` on 127.0.0.1:8000, as `app.service` under systemd",
      "port": 8000,
      "data": "~/app"
    },
    {
      "name": "Python 3.13 and uv",
      "detail": "uv installs Python and your locked dependencies into `~/app/.venv`"
    },
    {
      "name": "SQLite",
      "detail": "the starter's data and its visitors' questions",
      "data": "~/data"
    },
    {
      "name": "Deploy hook",
      "detail": "`git push` installs, runs the app once headless, restarts, and checks; a failure rejects the push",
      "data": "~/app.git"
    },
    {
      "name": "Data refresh",
      "detail": "`app-refresh.timer` runs `refresh.py` every hour"
    },
    {
      "name": "Nightly backup",
      "detail": "a systemd timer; keeps two weeks",
      "data": "~/backups"
    }
  ],
  "access": [
    {
      "url": "https://my-streamlit.exe.xyz/",
      "who": "private",
      "what": "your app, for you and the people you share it with"
    },
    {
      "url": "my-streamlit.exe.xyz:app.git",
      "who": "private",
      "what": "`git push exe main` deploys"
    }
  ],
  "inputs": [
    {
      "name": "REPO",
      "description": "the app to deploy: a GitHub repository (owner/name or a URL), a Hugging Face Space URL, or `new` to start from a small Streamlit dashboard"
    }
  ],
  "delivers": [
    "Your app, or a new Streamlit starter dashboard, running as `app.service` on 127.0.0.1:8000 and enabled to start after a reboot.",
    "`git push exe main` deploys: the hook builds a new release in `~/releases` with uv, runs a Streamlit app once headless with Streamlit's AppTest, switches `~/app` to it, restarts, and checks it answers. A failed deploy rejects the push and leaves the running version up.",
    "The app private behind exe.dev login, reading the viewer's email from the `X-ExeDev-Email` header (`st.context.headers` in Streamlit, `gr.Request` in Gradio).",
    "Settings and secrets outside the repository, mode 600, in `~/app.env` and `~/.streamlit/secrets.toml` (`st.secrets`).",
    "Data in `~/data`, refreshed every hour by `app-refresh.timer` in the starter, and backed up every night to `~/backups`, with a backup restored and checked in a scratch directory."
  ],
  "owner_runs_after": [
    "git clone -o exe my-streamlit.exe.xyz:app.git    # if you started fresh",
    "git remote add exe my-streamlit.exe.xyz:app.git  # or, in your own app's checkout"
  ],
  "deployable": true,
  "deploy": {
    "new_vm_url": "https://exe-staging.dev/new?prompt=REPO%3D%3Cfill-this-in%3E%0A%0ASet%20up%20Streamlit%20on%20this%20VM%20by%20following%20the%20exe.dev%20recipe%20at%20https%3A%2F%2Fexe-staging.dev%2Fdeploy%2Fstreamlit.md%20from%20top%20to%20bottom.%0A%0AThe%20values%20at%20the%20top%20of%20this%20message%20are%20mine%3A%0A-%20REPO%3A%20the%20app%20to%20deploy%3A%20a%20GitHub%20repository%20%28owner%2Fname%20or%20a%20URL%29%2C%20a%20Hugging%20Face%20Space%20URL%2C%20or%20%60new%60%20to%20start%20from%20a%20small%20Streamlit%20dashboard%0AAsk%20me%20for%20any%20that%20still%20say%20%3Cfill-this-in%3E%20before%20you%20need%20them.%0A%0AThe%20recipe%27s%20example%20VM%20name%20is%20my-streamlit.%20This%20VM%27s%20name%20is%20the%20output%20of%20%60hostname%60%3A%20use%20it%20wherever%20the%20recipe%20writes%20my-streamlit.%20Skip%20the%20step%20that%20creates%20the%20VM%3B%20you%20are%20on%20it.%0A%0AYou%20are%20done%20when%20all%20of%20these%20are%20true.%20Check%20each%20one%20yourself%3A%0A-%20Your%20app%2C%20or%20a%20new%20Streamlit%20starter%20dashboard%2C%20running%20as%20%60app.service%60%20on%20127.0.0.1%3A8000%20and%20enabled%20to%20start%20after%20a%20reboot.%0A-%20%60git%20push%20exe%20main%60%20deploys%3A%20the%20hook%20builds%20a%20new%20release%20in%20%60~%2Freleases%60%20with%20uv%2C%20runs%20a%20Streamlit%20app%20once%20headless%20with%20Streamlit%27s%20AppTest%2C%20switches%20%60~%2Fapp%60%20to%20it%2C%20restarts%2C%20and%20checks%20it%20answers.%20A%20failed%20deploy%20rejects%20the%20push%20and%20leaves%20the%20running%20version%20up.%0A-%20The%20app%20private%20behind%20exe.dev%20login%2C%20reading%20the%20viewer%27s%20email%20from%20the%20%60X-ExeDev-Email%60%20header%20%28%60st.context.headers%60%20in%20Streamlit%2C%20%60gr.Request%60%20in%20Gradio%29.%0A-%20Settings%20and%20secrets%20outside%20the%20repository%2C%20mode%20600%2C%20in%20%60~%2Fapp.env%60%20and%20%60~%2F.streamlit%2Fsecrets.toml%60%20%28%60st.secrets%60%29.%0A-%20Data%20in%20%60~%2Fdata%60%2C%20refreshed%20every%20hour%20by%20%60app-refresh.timer%60%20in%20the%20starter%2C%20and%20backed%20up%20every%20night%20to%20%60~%2Fbackups%60%2C%20with%20a%20backup%20restored%20and%20checked%20in%20a%20scratch%20directory.%0A%0ARead%20the%20whole%20recipe%2C%20including%20the%20closed%20details%2C%20and%20follow%20%22Set%20up%0Aby%20hand%22%20in%20order%2C%20skipping%20VM%20creation.%20The%20walkthrough%20above%20it%20is%20for%0Athe%20owner%20afterwards.%20Ask%20for%20REPO%20first%20if%20it%20says%20%3Cfill-this-in%3E.%0AFor%20REPO%3Dnew%2C%20build%20the%20starter%20exactly%20as%20written.%20For%20a%20GitHub%0Arepository%20or%20a%20Hugging%20Face%20Space%2C%20follow%20%22Bring%20your%20app%22%3A%20set%0AAPP_FILE%20and%20the%20other%20settings%20in%20~%2Fapp.env%2C%20and%20for%20a%20Gradio%20app%0Achange%20ExecStart%20as%20it%20says.%20Never%20commit%20to%20the%20owner%27s%20repository%20or%0Apush%20to%20~%2Fapp.git%20%28run%20the%20hook%20by%20hand%20instead%29%2C%20so%20the%20owner%27s%20first%0Apush%20fast-forwards.%20Remove%20whatever%20you%20make%20only%20for%20testing.%20If%20a%0Aprivate%20GitHub%20repository%20can%27t%20be%20cloned%2C%20give%20the%20owner%20the%0A%60integrations%20add%20github%60%20command%20with%20this%20VM%27s%20name%20and%20wait%20for%20them.%0AIf%20the%20app%20needs%20API%20keys%20you%20don%27t%20have%2C%20say%20which%2C%20and%20where%20they%20go.%0ADon%27t%20reboot%2C%20don%27t%20make%20the%20VM%20public%2C%20and%20don%27t%20run%20the%20Restore%20steps%0Aon%20live%20data%3A%20test%20the%20backup%20in%20a%20scratch%20directory%20as%20written.%0AThe%20VM%20can%27t%20open%20its%20own%20https%3A%2F%2F%3Cvm%3E.exe.xyz%3B%20%22Check%20it%22%20tests%0Athrough%20localhost%20instead.%20Skip%20the%20optional%20sections%20%28Gradio%20next%20to%0AStreamlit%2C%20integrations%2C%20public%20access%29%20unless%20the%20owner%20asks.%0AFinish%20with%20https%3A%2F%2F%3Cvm%3E.exe.xyz%2F%20and%20only%20the%20one%20git%20command%20from%0A%22Deploy%20with%20git%20push%22%20that%20fits%3A%20%60git%20clone%20-o%20exe%60%20for%20REPO%3Dnew%2C%0A%60git%20remote%20add%20exe%60%20for%20a%20repository%2C%20plus%20the%20branch%20to%20push%20if%20it%0Aisn%27t%20main%2C%20and%20anything%20you%20adapted%20or%20that%20the%20owner%20should%20change.%0A%0AFinish%20with%20the%20URLs%20I%20should%20open%20and%20these%20commands%2C%20which%20only%20I%20can%20run%2C%20from%20my%20own%20computer%20%28with%20this%20VM%27s%20name%20in%20them%29%3A%0A%20%20git%20clone%20-o%20exe%20my-streamlit.exe.xyz%3Aapp.git%20%20%20%20%23%20if%20you%20started%20fresh%0A%20%20git%20remote%20add%20exe%20my-streamlit.exe.xyz%3Aapp.git%20%20%23%20or%2C%20in%20your%20own%20app%27s%20checkout%0A",
    "terminal": "curl -fsSL https://exe-staging.dev/deploy/streamlit/prompt.txt | ssh exe.dev new --prompt=/dev/stdin",
    "prompt": "REPO=\u003cfill-this-in\u003e\n\nSet up Streamlit on this VM by following the exe.dev recipe at https://exe-staging.dev/deploy/streamlit.md from top to bottom.\n\nThe values at the top of this message are mine:\n- REPO: the app to deploy: a GitHub repository (owner/name or a URL), a Hugging Face Space URL, or `new` to start from a small Streamlit dashboard\nAsk me for any that still say \u003cfill-this-in\u003e before you need them.\n\nThe recipe's example VM name is my-streamlit. This VM's name is the output of `hostname`: use it wherever the recipe writes my-streamlit. Skip the step that creates the VM; you are on it.\n\nYou are done when all of these are true. Check each one yourself:\n- Your app, or a new Streamlit starter dashboard, running as `app.service` on 127.0.0.1:8000 and enabled to start after a reboot.\n- `git push exe main` deploys: the hook builds a new release in `~/releases` with uv, runs a Streamlit app once headless with Streamlit's AppTest, switches `~/app` to it, restarts, and checks it answers. A failed deploy rejects the push and leaves the running version up.\n- The app private behind exe.dev login, reading the viewer's email from the `X-ExeDev-Email` header (`st.context.headers` in Streamlit, `gr.Request` in Gradio).\n- Settings and secrets outside the repository, mode 600, in `~/app.env` and `~/.streamlit/secrets.toml` (`st.secrets`).\n- Data in `~/data`, refreshed every hour by `app-refresh.timer` in the starter, and backed up every night to `~/backups`, with a backup restored and checked in a scratch directory.\n\nRead the whole recipe, including the closed details, and follow \"Set up\nby hand\" in order, skipping VM creation. The walkthrough above it is for\nthe owner afterwards. Ask for REPO first if it says \u003cfill-this-in\u003e.\nFor REPO=new, build the starter exactly as written. For a GitHub\nrepository or a Hugging Face Space, follow \"Bring your app\": set\nAPP_FILE and the other settings in ~/app.env, and for a Gradio app\nchange ExecStart as it says. Never commit to the owner's repository or\npush to ~/app.git (run the hook by hand instead), so the owner's first\npush fast-forwards. Remove whatever you make only for testing. If a\nprivate GitHub repository can't be cloned, give the owner the\n`integrations add github` command with this VM's name and wait for them.\nIf the app needs API keys you don't have, say which, and where they go.\nDon't reboot, don't make the VM public, and don't run the Restore steps\non live data: test the backup in a scratch directory as written.\nThe VM can't open its own https://\u003cvm\u003e.exe.xyz; \"Check it\" tests\nthrough localhost instead. Skip the optional sections (Gradio next to\nStreamlit, integrations, public access) unless the owner asks.\nFinish with https://\u003cvm\u003e.exe.xyz/ and only the one git command from\n\"Deploy with git push\" that fits: `git clone -o exe` for REPO=new,\n`git remote add exe` for a repository, plus the branch to push if it\nisn't main, and anything you adapted or that the owner should change.\n\nFinish with the URLs I should open and these commands, which only I can run, from my own computer (with this VM's name in them):\n  git clone -o exe my-streamlit.exe.xyz:app.git    # if you started fresh\n  git remote add exe my-streamlit.exe.xyz:app.git  # or, in your own app's checkout\n",
    "prompt_url": "https://exe-staging.dev/deploy/streamlit/prompt.txt"
  },
  "updated": "2026-11-16",
  "verified": "2026-11-16",
  "related": [
    "fastapi",
    "flask",
    "marimo",
    "sqlite",
    "postgres",
    "open-webui"
  ],
  "alternatives": [
    "Streamlit Community Cloud",
    "Hugging Face Spaces"
  ]
}
