Back to index
OtherA weekend for the core concepts·Free, Community Cloud hosting free

Streamlit Official Documentation and Tutorials

4.2

The fastest route from a notebook to something a colleague can click, and the docs teach it well. Just be clear that you are learning a demo tool, not web development.

What We Liked

  • You can build something genuinely useful within an hour of starting
  • Documentation is well organised with a clear separation of concepts, API and tutorials
  • The execution model is explained properly rather than left as a mystery
  • Free Community Cloud deployment means you can share a link the same day
  • Removes the front end barrier that stops data people from showing their work

What Could Be Better

  • The rerun on every interaction model confuses newcomers and the docs could front-load it more
  • Not suitable for real production applications and the docs are quiet about where the ceiling is
  • Authentication, multi-user state and scaling get much less coverage than they need
  • Component ecosystem is uneven and third party components break between versions
  • Snowflake ownership means feature direction increasingly favours their platform

Detailed review

There is a specific career problem that Streamlit solves better than anything else, which is that a model sitting in a notebook is invisible to everyone who makes decisions. You can have done excellent work and have it die in a repository because the only artefact is a Jupyter file nobody will open. Streamlit turns that script into a URL, and the documentation does a good job of teaching you how. The docs are structured sensibly into get started, develop, deploy and API reference, and the concepts section is the part that matters.

It explains the execution model up front: your script reruns top to bottom on every interaction, and state does not persist unless you make it persist. This is the single thing that trips up everyone who arrives expecting an event driven framework, and while the docs do explain it, I would put it in flashing letters on the first page rather than in a concepts section people skip. Once it clicks, everything else about the framework becomes obvious. Once past that, the learning curve is genuinely gentle.

Widgets are one line each. Caching with the data and resource decorators is well documented and explained in terms of when each is appropriate rather than as a recipe. Session state gets a proper page. The layout primitives, columns, tabs, containers, expanders, cover what most internal tools need.

Charting integrates with the plotting libraries people already use rather than inventing another one. The tutorials are practical and the API reference is complete and searchable. Community Cloud deserves a mention because free hosting changes the calculation entirely. Push to GitHub, connect the repo, get a link.

For sharing a prototype with stakeholders that is the whole workflow, and it is the reason Streamlit spread through data teams the way it did. Where I would push back. The docs are optimistic about what Streamlit is for. Somewhere between a demo and an internal tool there is a line past which you are fighting the framework, and the documentation does not tell you where it is.

Anything needing real authentication, per user data isolation, background jobs, complex routing or serious concurrency is going to hurt. People discover this after building something their organisation has come to depend on, and the migration is painful. A clear-eyed page on when to stop using Streamlit would improve the docs enormously. Authentication in particular is thin.

The native support that exists covers basic cases and the docs hand you off quickly for anything else, which is a gap given how many of these apps end up holding data that should not be public. The third party component ecosystem is a mixed experience: some components are excellent, many are abandoned, and version compatibility is a recurring annoyance that the official docs cannot really address. Snowflake acquired Streamlit and the direction of travel is visible in how much of the newer material assumes or favours their platform. The open source project remains genuinely open and usable standalone, and I do not think this is a reason to avoid it, but it is worth knowing whose roadmap you are on.

Compared to Gradio, also in this catalogue, Streamlit gives you more layout control and a better fit for dashboards and internal tools, while Gradio is faster for a single model demo and integrates more naturally with Hugging Face. Most people should learn both, they take an afternoon each. My four point two is for documentation that teaches a genuinely valuable skill clearly and quickly, marked down for being insufficiently honest about the framework's ceiling and for thin coverage of the production concerns that catch people out.

[ final ]

The verdict.

Learn it. Every data scientist should be able to ship a Streamlit app, because being able to show your work is a career skill. Do not mistake it for learning to build software.