Playground
Run the published package without installing Python. The playground starts a private Python session in your browser, installs PyWorldAtlas from PyPI, and keeps that session alive while you explore.
Python in your browser
Explore the atlas
Choose one of fourteen complete recipes or write your own query. Press Ctrl/⌘ + Enter to run it.
Ready-to-run recipe library
Python is starting. The first load can take a moment.
What is running?
This is the real pyworldatlas==0.8.1 wheel published on PyPI, not a
JavaScript imitation or a remote demonstration API. Pyodide runs CPython in
WebAssembly, while a module Web Worker keeps execution away from the page’s
interface. After startup, country queries read the same bundled SQLite database
used by a normal installation.
The first visit downloads the Python runtime from a pinned public CDN, with a
second provider available if the first cannot be reached, and the wheel from
PyPI. Code entered in the editor is evaluated on your device; this project does
not receive its contents. Each run has a 20-second safety limit, and interactive
input() calls are not supported.
Things worth trying
The fourteen guided programs cover four different ways to use the package:
Meet the world: summarize the atlas, build a rich country dossier, compare profiles, and cross original writing systems.
Measure and connect: calculate distance, bearing, and midpoint; locate nearby capitals; follow a land-border path; and connect profiles through source-listed rivers and lakes.
Analyze the atlas: build multi-metric leaderboards, visualize represented climate shares, inspect populated places, and combine search with filters.
Learn and build: generate repeatable quiz material and export portable, Unicode-preserving JSON.
Change a country name, adjust a ranking, or combine two examples. The Python session persists until you select Reset Python or close the page. The Example programs page presents the strongest programs as normal copy-ready Python alongside direct links back to the matching interactive recipe.
Use the package locally
For projects, notebooks, and unrestricted sessions, install the package in a normal Python environment:
python -m pip install --upgrade pyworldatlas
Then continue with the Quickstart or the complete API reference reference. Local installations need no network connection at runtime.