Mountaineer
Move fast. Climb mountains. Don't break things.
Mountaineer 🏔️ is a framework to easily build webapps in Python and React. If you've used either of these languages before for development, we think you'll be right at home.
Main Features
Each framework has its own unique features and tradeoffs. Mountaineer focuses on developer productivity above all else, with production speed a close second.
- 📝 Typehints up and down the stack: frontend, backend, and database
- 🎙️ Trivially easy client<->server communication, data binding, and function calling
- 🌎 Optimized server rendering for better accessibility and SEO
- 🏹 Static analysis of web pages for strong validation: link validity, data access, etc.
- 🤩 Skip the API or Node.js server just to serve frontend clients
Getting Started
New Project
To get started as quickly as possible, we bundle a project generator that sets up a simple project after a quick Q&A. Make sure you have pipx installed.
$ pipx run create-mountaineer-app
Mountaineer projects all follow a similar structure. After running this CLI you should see a new folder called my_webapp, with folders like the following:
my_webapp
/controllers
/home.py
/models
/mymodel.py
/views
/app
/home
/page.tsx
/layout.tsx
/package.json
/tsconfig.json
/app.py
/cli.py
pyproject.toml
Every service file is nested under the my_webapp root package. Views are defined in a disk-based hierarchy (views) where nested routes are in nested folders. This folder acts as your React project and is where you can define requirements and build parameters in package.json and tsconfig.json. Controllers are defined nearby in a flat folder (controllers) where each route is a separate file. Everything else is just standard Python code for you to modify as needed.
Development
If you're starting a new application from scratch, you'll typically want to create your new database tables. Make sure you have postgres running. We bundle a docker compose file for convenience with create-mountaineer-app.
docker compose up -d
uv run createdb
Of course you can also use an existing database instance, simply configure it in the .env file in the project root.
Mountaineer relies on watching your project for changes and doing progressive compilation. We provide a few CLI commands to help with this.
While doing development work, you'll usually want to preview the frontend and automatically build dependent files. You can do this with:
$ uv run mountaineer-dev
Found 4 Python libraries for warm reload: click, fastapi, mountaineer, pydantic
Started Python backend in 2.05s
Local http://127.0.0.1:5006
Navigate to http://127.0.0.1:5006 to see your new webapp running.
Or, if you just want to watch the source tree for changes without hosting the server. Watching will allow your frontend to pick up API definitions from your backend controllers:
$ uv run mountaineer-watch
Both native commands are installed with Mountaineer and discover the project automatically.
Documentation
1 maintainer
Metadata
1 maintainer
Release files for mountaineer 0.20.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mountaineer-0.20.0.tar.gz | 891.5 kB | Details |
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| mountaineer-0.20.0-cp310-abi3-win_amd64.whl | CPython 3.10 | abi3 | Windows x86-64 | Details |
| mountaineer-0.20.0-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl | CPython 3.10 | abi3 | Linux glibc 2.17+ x86-64 | Details |
| mountaineer-0.20.0-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl | CPython 3.10 | abi3 | Linux glibc 2.17+ ARM64 | Details |
| mountaineer-0.20.0-cp310-abi3-macosx_11_0_arm64.whl | CPython 3.10 | abi3 | macOS 11.0+ ARM64 | Details |
| mountaineer-0.20.0-cp310-abi3-macosx_10_12_x86_64.whl | CPython 3.10 | abi3 | macOS 10.12+ x86-64 | Details |
Total release size: 86.1 MB
Release files / mountaineer-0.20.0.tar.gz
| Download URL | mountaineer-0.20.0.tar.gz |
|---|---|
| Size | 891.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
9ce364d34da4598c25d0a67e5a8028da048ec9f79112d02af60e984307d5db8e
|
|
BLAKE2b-256 checksum How to use checksums |
dca691254f04a1e14e41ce6ae040173d02993b34a92d4b7de245ad7217db60dd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 23, 2026.
Transparency logRelease files / mountaineer-0.20.0-cp310-abi3-win_amd64.whl
| Download URL | mountaineer-0.20.0-cp310-abi3-win_amd64.whl |
|---|---|
| Size | 15.8 MB |
| Tags | CPython 3.10 Windows x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
2d00ed2573ab8002e02d603500f5ea0ce366f3aff0f44c77f82b2a2be7fc84e1
|
|
BLAKE2b-256 checksum How to use checksums |
4ec28f7b03cb11029e5f10cb3c7e15f4c1212796d87b951f6fbfcddb63743b3e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 23, 2026.
Transparency logRelease files / mountaineer-0.20.0-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
| Download URL | mountaineer-0.20.0-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl |
|---|---|
| Size | 17.9 MB |
| Tags | CPython 3.10 Linux glibc 2.17+ x86-64 abi3 |
|
SHA-256 checksum How to use checksums |
9a7ec21968596083d36c29b79f70ec2da15f839626f660068fd7f08a95190bf8
|
|
BLAKE2b-256 checksum How to use checksums |
ef161d141ece22fc4e5fe6ef993a0a5e85b8b5faf1e4a51367039c527f9abb64
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 23, 2026.
Transparency logRelease files / mountaineer-0.20.0-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
| Download URL | mountaineer-0.20.0-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl |
|---|---|
| Size | 18.3 MB |
| Tags | CPython 3.10 Linux glibc 2.17+ ARM64 abi3 |
|
SHA-256 checksum How to use checksums |
dd4508db75213d5538f8fd04417ebd6d27b5d80bcdaf5ee8c58dc2a1d2ae1f48
|
|
BLAKE2b-256 checksum How to use checksums |
09e80b29a260e769892d35381c9b9f64ce6ef2e786bd0adc15a3ef76463cef2f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 23, 2026.
Transparency logRelease files / mountaineer-0.20.0-cp310-abi3-macosx_11_0_arm64.whl
| Download URL | mountaineer-0.20.0-cp310-abi3-macosx_11_0_arm64.whl |
|---|---|
| Size | 16.1 MB |
| Tags | CPython 3.10 abi3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
ed1aecf901262936d640d74d83f22acfaaf849fa49b8606f81420018f34f215f
|
|
BLAKE2b-256 checksum How to use checksums |
cdedfb2e42a239281cd15610da784d42086981f8d333b06d98ed648cccfe6121
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 23, 2026.
Transparency logRelease files / mountaineer-0.20.0-cp310-abi3-macosx_10_12_x86_64.whl
| Download URL | mountaineer-0.20.0-cp310-abi3-macosx_10_12_x86_64.whl |
|---|---|
| Size | 17.0 MB |
| Tags | CPython 3.10 abi3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
14b9c566ad8c9c3b50ce59f19231cf85965f765429b338f5d178d5ea1546eb34
|
|
BLAKE2b-256 checksum How to use checksums |
0b6c941c3a5fb2de7177ddc7245dbd2054c52bb128269475801aea8fdeafbfc1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 23, 2026.
Transparency log
