Quick Links
Geoweaver is an in-browser software allowing users to easily compose and execute full-stack data processing workflows via taking advantage of online spatial data facilities, high-performance computation platforms, and open-source code management libraries. It provides all-in-one capacity covering server management, code repository, workflow orchestration software, and history recorder.
It can be run from both local and remote (distributed) machines.
Why Choose Geoweaver?
Key Benefits:
- Data Safety: Securely store and track all your research progress
- Research Organization: Stay organized throughout long-term research projects
- Seamless Connectivity: Easy SSH connection to external servers
- Python Integration: Built-in web UI with comprehensive Python support
- Community-Driven: Active community with ongoing development and support
For detailed information, visit Geoweaver Documentation.
Geoweaver is a community effort. Any contribution is welcome and greatly appreciated!
Features
Core Features
🖥️ Host Management
- Register and manage SSH-enabled machines for process execution
- Integrate Jupyter Servers for interactive workflow development
- Secure connection management with encrypted credentials
🔄 Process Management
- Support for multiple process types (Python, Bash, R, etc.)
- Real-time process monitoring and control
- Version control for process code
📓 Jupyter Integration
- Seamless notebook import/export
- Automatic version tracking
- Interactive notebook editing
📊 Workflow Orchestration
- Visual workflow builder
- Parallel and sequential execution support
- Cross-resource workflow distribution
- Centralized workflow management
📝 History & Logging
- Comprehensive execution history
- Detailed process logs
- Automated backup and recovery
🔍 Data Pipeline Visualization
- Interactive workflow diagrams
- Dependency tracking
- Real-time execution monitoring
⚡ Research Productivity
- Automated task scheduling
- Reduced manual intervention
- Focus on research, not infrastructure
Installation
Prerequisites
- ☕ Java 17 or higher (OpenJDK / Temurin 17+). Geoweaver 2.2+ (Spring Boot 3) does not support JDK < 17.
- If you cannot upgrade Java, stay on Geoweaver 2.1.x (Java 11): Releases (example: v2.1.7 jar).
- 🐳 Docker (optional)
What should I do?
| Situation | Recommendation |
|---|
| New install | Install Java 17+, then use Quick Start below (details). |
| Already on 2.1.x, can use Java 17 | Back up ~/h2, upgrade JDK, then upgrade jar / pygeoweaver (migration guide, upgrade). |
| Must stay on Java 11 | Keep Geoweaver 2.1.x; do not run the latest 2.2+ jar. |
Quick Start
🐍 Python Method (Recommended)
# Install PyGeoweaver
pip install pygeoweaver --upgrade
# Start Geoweaver (needs Java 17+ for current releases)
gw start
☕ Java Method
- Install Java 17+
- Download geoweaver.jar
- Run:
java -jar geoweaver.jar
🐳 Docker Method
# Pull the image
docker pull geoweaver/geoweaver
# Run Geoweaver
docker run -t -i -p 8070:8070 geoweaver/geoweaver
📝 Access Geoweaver at http://localhost:8070/Geoweaver
Detailed Installation Guide · Java 17 migration · Upgrading
Demo
A live demo site is available.
Documentation
Learn more about Geoweaver in its official documentation at https://esipfed.github.io/Geoweaver/docs/install.html
Creating a New Release
After merging to main, publish so clients can always download:
https://github.com/ESIPFed/Geoweaver/releases/download/latest/geoweaver.jar
./scripts/publish-latest-release.sh 2.2.1 --bump
Details: release instructions.
PyGeoWeaver is a Python package that provides a convenient and user-friendly interface to interact with GeoWeaver, a powerful geospatial data processing application written in Java. With PyGeoWeaver, Jupyter notebook and JupyterLab users can seamlessly integrate and utilize the capabilities of GeoWeaver within their Python workflows.
Please do visit the PyGeoWeaver GitHub repository.
Contributors
Thanks to our many contributors!
Geoweaver History
v0.6.7 - v1.0.0 (2018 - 2023)
Key features included:
- Made GitHub zip importable and added .wci.yml.
- Introduced a process stop button, organized the SSH folder, and enabled shell commands to call Python processes.
- Added buffer size control and exit code usage for process status.
- Fixed numerous issues on remote hosts.
- Included new features such as hovering tips and code comparison.
- Added process history and status.
- Added code search function.
- Enabled run button in side panel.
- Allows reset password from terminal.
v1.0.1 - v1.2.8 (2023 - 2024)
After incorporating feedback from the user community, the Geoweaver team released new versions. This major update focused on performance improvements and added several highly requested features:
- Log output is real time and web socket channels are untangled.
- Made the local logging real time.
- Created a macOS App for Geoweaver.
- Ability to Restore workflow.
- Run maven tests on github actions.
These versions solidified Geoweaver's position as a powerful open-source GIS solution and attracted interest from various industries and research institutions.
v1.3.0 - v1.6.1 (2024)
This version focuses on updating features and bug fixing:
- Fixed the chart visibility issue and table actions in side panel.
- Opens dock at bottom by default.
- Updated README.md by including latest features and modern style.
- Navigation fix for process tab and workflow tab in Guide page.
- Added filtering skipped process functionality.
- Responsive Design for lower resultion devices such as ipad / tablets.
- Support for MySQL and PostgreSQL - Production grade DB.
- Autosaves code on Run.
- Added support for Docker. The Geoweaver Docker image can be found here(https://hub.docker.com/repository/docker/geoweaver/geoweaver/general).
For more details, you can check the Geoweaver Releases Page.
Citation
If you found Geoweaver helpful in your research, please cite:
Sun, Z. et al., "Geoweaver: Advanced cyberinfrastructure for managing hybrid geoscientific AI workflows." ISPRS International Journal of Geo-Information 9, no. 2 (2020): 119.
Existing Projects
Sun, Ziheng, Nicoleta C. Cristea, Kehan Yang, Ahmed Alnuaim, Lakshmi Chetana Gomaram Bikshapathireddy, Aji John, Justin Pflug et al. "Making machine learning-based snow water equivalent forecasting research productive and reusable by Geoweaver." In AGU fall meeting abstracts, vol. 2022, pp. IN23A-04. 2022.
Sun, Ziheng, and Nicoleta Cristea. "Geoweaver for Automating ML-based High Resolution Snow Mapping Workflow." In AGU Fall Meeting Abstracts, vol. 2021, pp. IN11C-07. 2021.
Sun, Ziheng, Liping Di, Jason Tullis, Annie Bryant Burgess, and Andrew Magill. "Geoweaver: Connecting Dots for Artificial Intelligence in Geoscience." In AGU Fall Meeting Abstracts, vol. 2020, pp. IN011-02. 2020.
Sun, Ziheng, Liping Di, Annie Burgess, Jason A. Tullis, and Andrew B. Magill. "Geoweaver: Advanced cyberinfrastructure for managing hybrid geoscientific AI workflows." ISPRS International Journal of Geo-Information 9, no. 2 (2020): 119.
