{"id":350834,"name":"Itzï","description":"A powerful, open-source hydrologic and hydraulic modeling platform that makes flood simulation accessible to everyone.","url":"https://github.com/itzimodel/itzi","last_synced_at":"2026-06-13T03:30:31.779Z","repository":{"id":92239341,"uuid":"264452503","full_name":"ItziModel/itzi","owner":"ItziModel","description":"A dynamic GIS flood model","archived":false,"fork":false,"pushed_at":"2026-05-19T21:55:37.000Z","size":4120,"stargazers_count":58,"open_issues_count":35,"forks_count":24,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-06-01T22:05:15.339Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://www.itzi.org","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ItziModel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2020-05-16T14:16:04.000Z","updated_at":"2026-05-25T07:19:58.000Z","dependencies_parsed_at":"2026-04-21T02:02:27.210Z","dependency_job_id":null,"html_url":"https://github.com/ItziModel/itzi","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"purl":"pkg:github/ItziModel/itzi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ItziModel%2Fitzi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ItziModel%2Fitzi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ItziModel%2Fitzi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ItziModel%2Fitzi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ItziModel","download_url":"https://codeload.github.com/ItziModel/itzi/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ItziModel%2Fitzi/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34226629,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-12T02:00:06.859Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"owner":{"login":"ItziModel","name":"ItziModel","uuid":"65320729","kind":"organization","description":null,"email":null,"website":null,"location":null,"twitter":null,"company":null,"icon_url":"https://avatars.githubusercontent.com/u/65320729?v=4","repositories_count":1,"last_synced_at":"2023-02-28T18:21:59.714Z","metadata":{"has_sponsors_listing":false},"html_url":"https://github.com/ItziModel","funding_links":[],"total_stars":null,"followers":null,"following":null,"created_at":"2023-02-28T18:21:59.718Z","updated_at":"2023-02-28T18:21:59.718Z","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ItziModel","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ItziModel/repositories"},"packages":[{"id":2771198,"name":"itzi","ecosystem":"pypi","description":"A distributed dynamic flood model.","homepage":"http://www.itzi.org","licenses":"GPL-2.0-or-later","normalized_licenses":["GPL-2.0-or-later"],"repository_url":"https://github.com/ItziModel/itzi","keywords_array":["science","engineering","hydrology","flood"],"namespace":null,"versions_count":13,"first_release_published_at":"2016-07-15T16:51:30.000Z","latest_release_published_at":"2025-08-07T04:04:30.000Z","latest_release_number":"25.8","last_synced_at":"2026-05-27T20:00:33.072Z","created_at":"2022-04-10T11:20:51.055Z","updated_at":"2026-05-27T20:00:33.072Z","registry_url":"https://pypi.org/project/itzi/","install_command":"pip install itzi --index-url https://pypi.org/simple","documentation_url":"https://itzi.readthedocs.io","metadata":{"funding":null,"documentation":"https://itzi.readthedocs.io","classifiers":["Development Status :: 4 - Beta","Environment :: Console","Intended Audience :: Science/Research","Operating System :: OS Independent","Programming Language :: Cython","Programming Language :: Python :: 3 :: Only","Topic :: Scientific/Engineering","Topic :: Scientific/Engineering :: Hydrology"],"normalized_name":"itzi","project_status":null},"repo_metadata":{"id":92239341,"uuid":"264452503","full_name":"ItziModel/itzi","owner":"ItziModel","description":"A dynamic GIS flood model","archived":false,"fork":false,"pushed_at":"2026-05-11T19:43:13.000Z","size":4021,"stargazers_count":57,"open_issues_count":34,"forks_count":24,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-05-15T14:04:40.655Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://www.itzi.org","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ItziModel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2020-05-16T14:16:04.000Z","updated_at":"2026-05-10T13:19:20.000Z","dependencies_parsed_at":"2026-04-21T02:02:27.210Z","dependency_job_id":null,"html_url":"https://github.com/ItziModel/itzi","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"purl":"pkg:github/ItziModel/itzi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ItziModel%2Fitzi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ItziModel%2Fitzi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ItziModel%2Fitzi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ItziModel%2Fitzi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ItziModel","download_url":"https://codeload.github.com/ItziModel/itzi/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ItziModel%2Fitzi/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33223673,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-19T15:49:41.270Z","status":"ssl_error","status_checked_at":"2026-05-19T15:49:22.917Z","response_time":58,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"},"tags":[]},"repo_metadata_updated_at":"2026-05-19T16:20:21.810Z","dependent_packages_count":0,"downloads":292,"downloads_period":"last-month","dependent_repos_count":2,"rankings":{"downloads":32.597943361936096,"dependent_repos_count":11.608281140065833,"dependent_packages_count":10.020148805929232,"stargazers_count":null,"forks_count":null,"docker_downloads_count":null,"average":18.075457769310386},"purl":"pkg:pypi/itzi","advisories":[],"docker_usage_url":"https://docker.ecosyste.ms/usage/pypi/itzi","docker_dependents_count":1,"docker_downloads_count":40,"usage_url":"https://repos.ecosyste.ms/usage/pypi/itzi","dependent_repositories_url":"https://repos.ecosyste.ms/api/v1/usage/pypi/itzi/dependencies","status":null,"funding_links":[],"critical":null,"issue_metadata":{"last_synced_at":"2026-04-29T06:00:34.334Z","issues_count":45,"pull_requests_count":28,"avg_time_to_close_issue":64736156.04,"avg_time_to_close_pull_request":32594.823529411766,"issues_closed_count":25,"pull_requests_closed_count":17,"pull_request_authors_count":2,"issue_authors_count":11,"avg_comments_per_issue":1.1333333333333333,"avg_comments_per_pull_request":0.0,"merged_pull_requests_count":17,"bot_issues_count":0,"bot_pull_requests_count":3,"past_year_issues_count":31,"past_year_pull_requests_count":28,"past_year_avg_time_to_close_issue":1554691.3636363635,"past_year_avg_time_to_close_pull_request":32594.823529411766,"past_year_issues_closed_count":11,"past_year_pull_requests_closed_count":17,"past_year_pull_request_authors_count":2,"past_year_issue_authors_count":3,"past_year_avg_comments_per_issue":0.3870967741935484,"past_year_avg_comments_per_pull_request":0.0,"past_year_bot_issues_count":0,"past_year_bot_pull_requests_count":3,"past_year_merged_pull_requests_count":17,"issues_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories/ItziModel%2Fitzi/issues","maintainers":[],"active_maintainers":[]},"versions_url":"https://packages.ecosyste.ms/api/v1/registries/pypi.org/packages/itzi/versions","version_numbers_url":"https://packages.ecosyste.ms/api/v1/registries/pypi.org/packages/itzi/version_numbers","latest_version_url":"https://packages.ecosyste.ms/api/v1/registries/pypi.org/packages/itzi/latest_version","dependent_packages_url":"https://packages.ecosyste.ms/api/v1/registries/pypi.org/packages/itzi/dependent_packages","related_packages_url":"https://packages.ecosyste.ms/api/v1/registries/pypi.org/packages/itzi/related_packages","codemeta_url":"https://packages.ecosyste.ms/api/v1/registries/pypi.org/packages/itzi/codemeta","maintainers":[{"uuid":"lrntct","login":"lrntct","name":null,"email":null,"url":null,"packages_count":5,"html_url":"https://pypi.org/user/lrntct/","role":null,"created_at":"2023-02-24T11:59:49.349Z","updated_at":"2023-02-24T11:59:49.349Z","packages_url":"https://packages.ecosyste.ms/api/v1/registries/pypi.org/maintainers/lrntct/packages"}],"registry":{"name":"pypi.org","url":"https://pypi.org","ecosystem":"pypi","default":true,"packages_count":875868,"maintainers_count":374677,"namespaces_count":0,"keywords_count":285845,"github":"pypi","metadata":{"funded_packages_count":54057},"icon_url":"https://github.com/pypi.png","created_at":"2022-04-04T15:19:23.364Z","updated_at":"2026-05-29T05:11:24.287Z","packages_url":"https://packages.ecosyste.ms/api/v1/registries/pypi.org/packages","maintainers_url":"https://packages.ecosyste.ms/api/v1/registries/pypi.org/maintainers","namespaces_url":"https://packages.ecosyste.ms/api/v1/registries/pypi.org/namespaces"}}],"commits":{"id":11389315,"full_name":"ItziModel/itzi","default_branch":"master","total_commits":829,"total_committers":1,"total_bot_commits":0,"total_bot_committers":0,"mean_commits":829.0,"dds":0.0,"past_year_total_commits":64,"past_year_total_committers":1,"past_year_total_bot_commits":0,"past_year_total_bot_committers":0,"past_year_mean_commits":64.0,"past_year_dds":0.0,"last_synced_at":"2026-05-27T20:00:39.177Z","last_synced_commit":"e113ebed53cf1c1bddce85547d55f7688de70ee1","created_at":"2025-09-28T08:54:43.339Z","updated_at":"2026-05-27T20:00:39.125Z","committers":[{"name":"Laurent Courty","email":"lrntct@gmail.com","login":"lrntct","count":829}],"past_year_committers":[{"name":"Laurent Courty","email":"lrntct@gmail.com","login":"lrntct","count":64}],"commits_url":"https://commits.ecosyste.ms/api/v1/hosts/GitHub/repositories/ItziModel%2Fitzi/commits","host":{"name":"GitHub","url":"https://github.com","kind":"github","last_synced_at":"2026-06-01T00:00:26.082Z","repositories_count":6252937,"commits_count":884158983,"contributors_count":35035512,"owners_count":1162151,"icon_url":"https://github.com/github.png","host_url":"https://commits.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://commits.ecosyste.ms/api/v1/hosts/GitHub/repositories"}},"issues_stats":{"full_name":"ItziModel/itzi","html_url":"https://github.com/ItziModel/itzi","last_synced_at":"2026-05-21T17:01:40.932Z","status":"active","issues_count":45,"pull_requests_count":29,"avg_time_to_close_issue":64736156.04,"avg_time_to_close_pull_request":32594.823529411766,"issues_closed_count":25,"pull_requests_closed_count":17,"pull_request_authors_count":2,"issue_authors_count":11,"avg_comments_per_issue":1.1333333333333333,"avg_comments_per_pull_request":0.0,"merged_pull_requests_count":17,"bot_issues_count":0,"bot_pull_requests_count":4,"past_year_issues_count":31,"past_year_pull_requests_count":29,"past_year_avg_time_to_close_issue":1554691.3636363635,"past_year_avg_time_to_close_pull_request":32594.823529411766,"past_year_issues_closed_count":11,"past_year_pull_requests_closed_count":17,"past_year_pull_request_authors_count":2,"past_year_issue_authors_count":3,"past_year_avg_comments_per_issue":0.3870967741935484,"past_year_avg_comments_per_pull_request":0.0,"past_year_bot_issues_count":0,"past_year_bot_pull_requests_count":4,"past_year_merged_pull_requests_count":17,"created_at":"2025-08-29T11:45:00.503Z","updated_at":"2026-05-21T17:01:40.932Z","repository_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories/ItziModel%2Fitzi","issues_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories/ItziModel%2Fitzi/issues","issue_labels_count":{"enhancement":5,"critical":3,"minor":1,"documentation":1,"major":1,"good first issue":1,"bug":1},"pull_request_labels_count":{"minor":4,"python:uv":4,"dependencies":4},"issue_author_associations_count":{"CONTRIBUTOR":34,"NONE":11},"pull_request_author_associations_count":{"CONTRIBUTOR":25,"NONE":4},"issue_authors":{"lrntct":34,"vitduck":2,"wuxuedaifu":1,"Caesar05":1,"ldesousa":1,"honglioslo":1,"JSUNFGH":1,"cam1331":1,"geoendemics":1,"wanghai1988":1,"AlisterH":1},"pull_request_authors":{"lrntct":25,"dependabot[bot]":4},"host":{"name":"GitHub","url":"https://github.com","kind":"github","last_synced_at":"2026-05-23T00:00:30.079Z","repositories_count":14677265,"issues_count":34101092,"pull_requests_count":111620223,"authors_count":11271348,"icon_url":"https://github.com/github.png","host_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/repositories","owners_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/owners","authors_url":"https://issues.ecosyste.ms/api/v1/hosts/GitHub/authors"},"past_year_issue_labels_count":{"critical":2,"enhancement":2,"good first issue":1},"past_year_pull_request_labels_count":{"dependencies":4,"minor":4,"python:uv":4},"past_year_issue_author_associations_count":{"CONTRIBUTOR":28,"NONE":3},"past_year_pull_request_author_associations_count":{"CONTRIBUTOR":25,"NONE":4},"past_year_issue_authors":{"lrntct":28,"vitduck":2,"wuxuedaifu":1},"past_year_pull_request_authors":{"lrntct":25,"dependabot[bot]":4},"maintainers":[],"active_maintainers":[]},"events":{"total":{"ReleaseEvent":2,"DeleteEvent":7,"PullRequestEvent":63,"ForkEvent":1,"IssuesEvent":62,"WatchEvent":17,"IssueCommentEvent":43,"PushEvent":71,"CreateEvent":8},"last_year":{"DeleteEvent":7,"PullRequestEvent":63,"IssuesEvent":51,"WatchEvent":12,"IssueCommentEvent":20,"PushEvent":33,"CreateEvent":7}},"keywords":[],"dependencies":[{"ecosystem":"pypi","filepath":"docs/requirements.txt","sha":null,"kind":"manifest","created_at":"2023-05-16T21:45:38.845Z","updated_at":"2023-05-16T21:45:38.845Z","repository_link":"https://github.com/ItziModel/itzi/blob/main/docs/requirements.txt","dependencies":[{"id":9717407793,"package_name":"sphinx-argparse","ecosystem":"pypi","requirements":"*","direct":true,"kind":"runtime","optional":false}]},{"ecosystem":"actions","filepath":".github/workflows/build_wheels.yml","sha":null,"kind":"manifest","created_at":"2025-05-19T21:36:28.367Z","updated_at":"2025-05-19T21:36:28.367Z","repository_link":"https://github.com/ItziModel/itzi/blob/main/.github/workflows/build_wheels.yml","dependencies":[{"id":23208716794,"package_name":"actions/checkout","ecosystem":"actions","requirements":"v4","direct":true,"kind":"composite","optional":false},{"id":23208716795,"package_name":"pypa/cibuildwheel","ecosystem":"actions","requirements":"v2.23.2","direct":true,"kind":"composite","optional":false},{"id":23208716897,"package_name":"actions/upload-artifact","ecosystem":"actions","requirements":"v4","direct":true,"kind":"composite","optional":false}]},{"ecosystem":"actions","filepath":".github/workflows/tests.yml","sha":null,"kind":"manifest","created_at":"2025-05-19T21:36:30.206Z","updated_at":"2025-05-19T21:36:30.206Z","repository_link":"https://github.com/ItziModel/itzi/blob/main/.github/workflows/tests.yml","dependencies":[{"id":23208716898,"package_name":"actions/checkout","ecosystem":"actions","requirements":"v4","direct":true,"kind":"composite","optional":false},{"id":23208716899,"package_name":"actions/upload-artifact","ecosystem":"actions","requirements":"v4","direct":true,"kind":"composite","optional":false}]},{"ecosystem":"actions","filepath":".github/workflows/upload_pypi.yml","sha":null,"kind":"manifest","created_at":"2025-05-19T21:36:30.263Z","updated_at":"2025-05-19T21:36:30.263Z","repository_link":"https://github.com/ItziModel/itzi/blob/main/.github/workflows/upload_pypi.yml","dependencies":[]},{"ecosystem":"pypi","filepath":"pyproject.toml","sha":null,"kind":"manifest","created_at":"2025-05-19T21:36:31.222Z","updated_at":"2025-05-19T21:36:31.222Z","repository_link":"https://github.com/ItziModel/itzi/blob/main/pyproject.toml","dependencies":[{"id":23208716955,"package_name":"numpy","ecosystem":"pypi","requirements":"==2.2.*","direct":true,"kind":"runtime","optional":false},{"id":23208716956,"package_name":"pyinstrument","ecosystem":"pypi","requirements":"==5.*","direct":true,"kind":"runtime","optional":false},{"id":23208716970,"package_name":"pyswmm","ecosystem":"pypi","requirements":"\u003e=2.0.1","direct":true,"kind":"runtime","optional":false},{"id":23208716978,"package_name":"bmipy","ecosystem":"pypi","requirements":"\u003e=2.0.1","direct":true,"kind":"runtime","optional":false}]},{"ecosystem":"pypi","filepath":"setup.py","sha":null,"kind":"manifest","created_at":"2025-04-21T06:30:34.044Z","updated_at":"2025-04-21T06:30:34.044Z","repository_link":"https://github.com/ItziModel/itzi/blob/main/setup.py","dependencies":[]}],"score":10.34971065311646,"created_at":"2026-04-06T16:30:17.375Z","updated_at":"2026-06-13T03:30:31.780Z","avatar_url":"https://github.com/ItziModel.png","language":"Python","category":"Climate Change","sub_category":"Natural Hazard and Storms","monthly_downloads":292,"total_dependent_repos":2,"total_dependent_packages":0,"readme":"# Itzï 🌊\n\n[![Actions](https://github.com/ItziModel/itzi/actions/workflows/tests.yml/badge.svg)](https://github.com/ItziModel/itzi/actions/workflows/tests.yml)\n[![pypi](https://badge.fury.io/py/itzi.svg)](https://badge.fury.io/py/itzi)\n[![rtfd](https://readthedocs.org/projects/itzi/badge/?version=latest)](https://itzi.readthedocs.io/en/latest/?badge=latest)\n\n**Effortless flood modeling with seamless GIS integration**\n\nItzï is a powerful, open-source hydrologic and hydraulic modeling platform that makes flood simulation accessible to everyone.\nBuilt with GRASS GIS integration at its core, Itzï eliminates the complexity of traditional flood modeling workflows, allowing you to focus on what matters most: understanding and predicting water flow patterns.\n\n![Itzï Drainage Simulation](docs/img/itzi_glasgow.png)\n\n## 🚀 Why Choose Itzï?\n\n**🎯 GIS-Native Design**\n- **No data wrestling**: Work directly with your existing GIS data\n- **Resolution flexibility**: Change model resolution with a single command, no matter the resolution of your input data\n- **Seamless workflow**: From data preparation to results visualization, all within your familiar GIS environment\n\n**⚡ Advanced Capabilities**\n- **2D surface flow modeling** with a damped partial inertia numerical scheme\n- **Drainage inflow and overflow** with integrated SWMM coupling\n- **Space-time variability of inputs**: Easily model rainfall fields from weather radar or satellite data 📡\n\n**🔧 User-Friendly**\n- **Simple configuration**: Text-based parameter file\n- **Flexible boundaries**: Easy setup of inflows, outflows, and boundary conditions\n- **Rich outputs**: Generate animations, time series, and detailed flood maps\n\n## 📦 Quick Installation\n\n### Prerequisites\nItzï requires [GRASS GIS 8.4 or above](https://grass.osgeo.org/download/). Install GRASS first, then proceed with Itzï installation.\n\n### Recommended Installation (using uv)\nWe recommend using [uv](https://docs.astral.sh/uv) for the best installation experience:\n\n```bash\n# Install uv (if not already installed)\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n# Install Itzï\nuv tool install itzi\n\n# Verify installation\nitzi version\nitzi run -h\n```\n\n### Alternative Installation Methods\n```bash\n# Using pip\npip install itzi\n\n# Using pipx\npipx install itzi\n```\n\n### Updating\n```bash\n# Update to latest version\nuv tool upgrade itzi\n```\n\n## 🎯 Quick Start\n\n1. **Prepare your data** in GRASS (DEM, rainfall, friction data)\n2. **Create a parameter file** defining your simulation setup\n3. **Run the simulation**: `itzi run your_config.ini`\n4. **Visualize and analyze results** using GRASS tools, or export for external analysis\n\nCheck out our [comprehensive tutorial](https://itzi.rtfd.io/en/latest/tutorial.html) for a step-by-step walkthrough using real-world data.\n\n## 🌟 Key Features\n\n- **Dynamic 2D Surface Flow**: Simulate complex surface water movement on regular grids\n- **Drainage network integration**: Model culverts, storm drains, and urban drainage infrastructure with SWMM\n- **Map time series as input and output**: Generate detailed spatiotemporal analysis of flood events\n- **Mass balance monitoring**: Automatic detection of instabilities, no more garbage output\n- **Hydrology**: Space-time rainfall and Green-Ampt infiltration\n- **Cross-platform**: Runs on Linux, Windows, and macOS\n\n## 📚 Documentation \u0026 Support\n\n- **📖 Documentation**: [itzi.readthedocs.io](https://itzi.rtfd.io/)\n- **🌐 Website**: [itzi.org](https://www.itzi.org/)\n- **💻 Source Code**: [GitHub Repository](https://github.com/ItziModel/itzi)\n- **🐛 Issues**: [Report bugs or request features](https://github.com/ItziModel/itzi/issues)\n\n## 📄 Citation\n\nIf you use Itzï in your research, please cite:\n\n\u003e Courty, L. G., Pedrozo-Acuña, A., \u0026 Bates, P. D. (2017).\n\u003e Itzï (version 17.1): an open-source, distributed GIS model for dynamic flood simulation.\n\u003e *Geoscientific Model Development*, 10(4), 1835–1847.\n\u003e https://doi.org/10.5194/gmd-10-1835-2017\n\n## 🤝 Contributing\n\nWe welcome contributions from the community! Whether you're fixing bugs, adding features, or improving documentation, your help makes Itzï better for everyone.\n\n- **Contributing Guide**: See [CONTRIBUTING.md](CONTRIBUTING.md)\n- **Code of Conduct**: See [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)\n\n## 📜 License\n\nItzï is released under the GPL license. See [LICENSE](LICENSE) for details.\n\n---\n\n*Ready to model floods with ease? [Get started with our tutorial](https://itzi.rtfd.io/en/latest/tutorial.html) and join the growing community of Itzï users worldwide!*\n","funding_links":[],"readme_doi_urls":["https://doi.org/10.5194/gmd-10-1835-2017"],"works":{},"citation_counts":{},"total_citations":0,"keywords_from_contributors":[],"project_url":"https://ost.ecosyste.ms/api/v1/projects/350834","html_url":"https://ost.ecosyste.ms/projects/350834"}