Python-first terrain and scene rendering on top of Rust + WebGPU.
Interactive viewer, offscreen rendering, overlays, point clouds, notebooks, and production outputs.
Install
pip install forge3d
Optional extras:
pip install "forge3d[jupyter]" # notebook widget support
pip install "forge3d[datasets]" # on-demand sample datasets
pip install "forge3d[all]" # everything
Quick Start
import forge3d as f3d
dem_path = f3d.fetch_dem("rainier")
with f3d.open_viewer_async(terrain_path=dem_path, width=1440, height=900) as viewer:
viewer.set_z_scale(0.1)
viewer.set_orbit_camera(phi_deg=28, theta_deg=49, radius=5400, fov_deg=42)
viewer.set_sun(azimuth_deg=302, elevation_deg=24)
viewer.snapshot("rainier.png", width=1920, height=1080)
What forge3d Covers
Open-source workflow:
- Interactive terrain viewing through
open_viewer_async()andViewerHandle - Terrain snapshots from GeoTIFF or
numpyDEM inputs - Raster overlays, vector overlays, labels, and camera automation
- LAZ/COPC/EPT point-cloud loading
- COG access, CRS helpers, datasets, presets, and notebook widgets
- Native/offscreen rendering with
Scene,Session,TerrainRenderer, andTerrainRenderParams - Geometry, mesh, vector, SDF, path-tracing, lighting, and terrain scatter helpers
Pro workflow:
MapPlate,Legend,ScaleBar, andNorthArrowfor cartographic composition- SVG/PDF vector export
- Building import pipelines for GeoJSON, CityJSON, and 3D Tiles workflows
- Mapbox-style import and scene bundles
Documentation Map
- Quickstart: install, first viewer session, first overlay, first notebook widget
- Feature Map: repo-wide overview of the supported workflows
- Examples Catalog: every script and notebook in
examples/ - Tutorials: guided GIS and Python tracks
- Gallery: finished recipes and visuals
- API Reference: the full public Python surface
Examples
The repo ships a broad set of runnable examples in examples/, including:
- interactive terrain scenes and raster overlays
- Mapbox-style, labels, and picking demos
- point-cloud and building viewers
- camera animation and terrain camera rigs
- COG streaming and offscreen terrain rendering
- pure-Python composition examples and notebooks
Run any script with python examples/<name>.py --help when it exposes CLI options.
License
The open-source core is released under Apache-2.0 OR MIT. Pro-gated features require a commercial license key set with forge3d.set_license_key(...).
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file forge3d-1.31.0.tar.gz.
File metadata
- Download URL: forge3d-1.31.0.tar.gz
- Upload date:
- Size: 3.1 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b9e8c42ed48bfa1163ccfe2a3005efb672916313f6a179ea469911c56a745ec5
|
|
| MD5 |
98cb9055753a5a3fd27c7d95562c6c95
|
|
| BLAKE2b-256 |
54173ba179a866381487e3f6afb6fdf2c01370a9f369e5362b1d6c6eea35caf1
|
File details
Details for the file forge3d-1.31.0-cp310-abi3-win_amd64.whl.
File metadata
- Download URL: forge3d-1.31.0-cp310-abi3-win_amd64.whl
- Upload date:
- Size: 10.2 MB
- Tags: CPython 3.10+, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
7aba5da4c6dd34f10d7d2c3ba8e04c743e0ab913d5acd5e45eef73caa3ca2240
|
|
| MD5 |
181c98069716cee6f0493e286f641525
|
|
| BLAKE2b-256 |
c0fd6bca5bf7e3d249c994fa45dcccded59126ca2f8a93aa12645397ed2b9a0a
|
File details
Details for the file forge3d-1.31.0-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl.
File metadata
- Download URL: forge3d-1.31.0-cp310-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
- Upload date:
- Size: 11.0 MB
- Tags: CPython 3.10+, manylinux: glibc 2.17+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ab0975880fc461bb8000cabc94ba8946dbefd339266adf0dc763d8a98447f781
|
|
| MD5 |
2d74177df24e5eeee180a49a249fbb7d
|
|
| BLAKE2b-256 |
368ca5b35da43f8f34a3a478e59135b8386833e8080d8121ade125a32280b815
|
File details
Details for the file forge3d-1.31.0-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl.
File metadata
- Download URL: forge3d-1.31.0-cp310-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl
- Upload date:
- Size: 10.8 MB
- Tags: CPython 3.10+, manylinux: glibc 2.17+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
04c1f7ea13983b05d4cd6e9c328bb90135d90f2476aa8906caaa3fb77d331fa4
|
|
| MD5 |
fdf2f7586937529625608ad4ed851cb5
|
|
| BLAKE2b-256 |
d3a847904aebdbcdd7b677e8afc083996bdcb4cca77b6d8fbc6d30c3d8cea477
|
File details
Details for the file forge3d-1.31.0-cp310-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl.
File metadata
- Download URL: forge3d-1.31.0-cp310-abi3-macosx_10_12_x86_64.macosx_11_0_arm64.macosx_10_12_universal2.whl
- Upload date:
- Size: 17.4 MB
- Tags: CPython 3.10+, macOS 10.12+ universal2 (ARM64, x86-64), macOS 10.12+ x86-64, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f7bc4a5fefb6675ed9d17985fc886ebdfd3eccb41840764eabe49d2065f176c5
|
|
| MD5 |
babfa9e03259b04b9645624a45ecb163
|
|
| BLAKE2b-256 |
61efb3eb1b98f91129fb183e9c3db62709e5ca88e1ad72cc5da27cbf69a9995f
|
