Add ultra-quickstart section to README and docs

Adds a prominent ultra-quickstart section showing the fastest way
to get started with Datasette using uv or pip:

- README.md: New 'Ultra-quickstart' section right after intro
- docs/getting_started.rst: Quickstart at the top
- docs/installation.rst: Added 'uv' as recommended installation method

Fixes #2625
This commit is contained in:
Test User 2026-02-07 17:40:08 -06:00
commit fcc95deb05
3 changed files with 45 additions and 0 deletions

View file

@ -17,6 +17,24 @@ Datasette is aimed at data journalists, museum curators, archivists, local gover
[Explore a demo](https://datasette.io/global-power-plants/global-power-plants), watch [a video about the project](https://simonwillison.net/2021/Feb/7/video/) or try it out [on GitHub Codespaces](https://github.com/datasette/datasette-studio).
## Ultra-quickstart
The fastest way to get started with Datasette if you have Python installed:
```bash
# Install with uv (recommended) or pip
uv tool install datasette
# Or: pip install datasette
# Serve a SQLite database
datasette my_database.db
# Or try it with a demo database
datasette https://datasette.io/fixtures.db
```
Then visit http://localhost:8001 to explore your data. See [Getting started](https://docs.datasette.io/en/stable/getting_started.html) for more.
* [datasette.io](https://datasette.io/) is the official project website
* Latest [Datasette News](https://datasette.io/news)
* Comprehensive documentation: https://docs.datasette.io/

View file

@ -1,6 +1,16 @@
Getting started
===============
Ultra-quickstart
----------------
Just want to get going? If you have Python installed::
uv tool install datasette # or: pip install datasette
datasette my_database.db
Then visit http://localhost:8001/ to explore your data.
.. _getting_started_demo:
Play with a live demo

View file

@ -17,6 +17,23 @@ If you want to start making contributions to the Datasette project by installing
Basic installation
==================
.. _installation_uv:
Using uv (recommended)
----------------------
`uv <https://docs.astral.sh/uv/>`__ is a fast Python package installer and resolver. It's the quickest way to install Datasette::
uv tool install datasette
You can then run Datasette with::
datasette --version
To upgrade to the latest version::
uv tool upgrade datasette
.. _installation_datasette_desktop:
Datasette Desktop for Mac