Skip to main content

climpact-web

The browser app for Climpact for Python (the climpact package, a Python port of the R Climpact): calculate the indices of daily climate extremes for a station, a batch of stations or gridded data, check the data quality and download the results, plots and report. A Django + htmx app. It depends on climpact at exactly the same version; the core never imports it.

Running it on your computer

pip install climpact-web
climpact-web

Python 3.12 or later. In a checkout of the repository, uv sync then uv run climpact-web does the same with the locked versions.

climpact-web keeps its database and results in your user data folder, applies database migrations, starts a background worker for the calculations, serves the app on http://127.0.0.1:8000/ and opens it in the browser. It needs no network connection. Options: --no-browser, --port, --host, --data-dir, --threads, --no-worker; climpact-web manage <command> runs a Django management command. Uploads and results are deleted after 7 days (CLIMPACT_WEB_RETENTION_DAYS). With CLIMPACT_WEB_DEBUG=true (or CLIMPACT_WEB_PATTERN_LIBRARY=true) the pattern library at /patterns/ shows every UI component.

Changing the styles

The stylesheet is written for Tailwind CSS and built by the standalone Tailwind CLI (#118); the built file, core/static/climpact_web/css/climpact.css, is committed, so running or installing the app needs no Tailwind. To change a template's classes or the source in core/tailwind/, from the repository root:

scripts/fetch-tailwind.sh                     # once: the pinned CLI into bin/, checksum checked
scripts/build-css.sh --watch                  # rebuild on every change
CLIMPACT_WEB_DEBUG=true uv run climpact-web   # in another terminal: changes show on reload
scripts/build-css.sh                          # one build before committing

CI rebuilds the stylesheet and fails if the committed file differs. Utilities go in the templates; repeated pieces, and classes built in Python or JavaScript, are components in core/tailwind/components/. See TECHNICAL.md, "Stylesheet and Tailwind".

Hosted mode

Set CLIMPACT_WEB_MODE=hosted, CLIMPACT_WEB_SECRET_KEY, CLIMPACT_WEB_ALLOWED_HOSTS, CLIMPACT_WEB_STATIC_ROOT and DATABASE_URL (Postgres: install the postgres extra), run climpact-web manage migrate and climpact-web manage collectstatic, and serve climpact_web.wsgi:application. Run one or more climpact-web manage runworker processes for the background jobs. The health check is /healthz.

All settings are listed in the technical notes, section "Web front end". The production container image is ghcr.io/geoffwalmsley/climpact-web.

Metadata

Release files for climpact-web 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for climpact-web 0.1.1
File Size Uploaded Provenance Actions
climpact_web-0.1.1.tar.gz 1.1 MB Without provenance Details for climpact_web-0.1.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for climpact-web 0.1.1
File Interpreter ABI Platform Actions
climpact_web-0.1.1-py3-none-any.whl Python 3 none any Details for climpact_web-0.1.1-py3-none-any.whl

Total release size: 2.3 MB

Release files / climpact_web-0.1.1.tar.gz

Download URL climpact_web-0.1.1.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums
3d75e30a5ed968891967da5893d12823314685141d7d8597ab148d1e4367edba
BLAKE2b-256 checksum
How to use checksums
0b41ba49c8bce5ae68f4aa6a6d015732ec5d79fee079ab85f5fc093ffddb9355
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / climpact_web-0.1.1-py3-none-any.whl

Download URL climpact_web-0.1.1-py3-none-any.whl
Size 1.2 MB
Tags Python 3
SHA-256 checksum
How to use checksums
ff4ee68b367783176be1933c961cd85c2d2ceb8c4ea70042d17136dd044ad848
BLAKE2b-256 checksum
How to use checksums
4d362c0171c97f669ae32248d28dbdd234885f7339a5c420b1ac6575e39b72cb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for climpact-web 0.1.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page