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.0

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.0
File Size Uploaded Provenance Actions
climpact_web-0.1.0.tar.gz 1.1 MB Without provenance Details for climpact_web-0.1.0.tar.gz

Built distribution (wheel)

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

Total release size: 2.3 MB

Release files / climpact_web-0.1.0.tar.gz

Download URL climpact_web-0.1.0.tar.gz
Size 1.1 MB
Tags Source
SHA-256 checksum
How to use checksums
64c75db315bc3960ca77f48815db6f816946b8a1219aefc1f071168f47bdcf17
BLAKE2b-256 checksum
How to use checksums
91a0356ea6683077578b78fc4c0b235378c62efc52553dbbf6f9103616254016
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.0-py3-none-any.whl

Download URL climpact_web-0.1.0-py3-none-any.whl
Size 1.2 MB
Tags Python 3
SHA-256 checksum
How to use checksums
3960e4d6af38ad8156c7cc8e0225e06dca745e5285f585fd6a456dec9edbaa89
BLAKE2b-256 checksum
How to use checksums
68789356cbc78d6d1c2cfa0d67cd82439cbb5e729b0ae9d746aa3684a90f8b56
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.0

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.0 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