H2O Wave 项目安装与快速入门指南

H2O Wave 项目安装与快速入门指南

wave Realtime Web Apps and Dashboards for Python and R 项目地址: https://gitcode.com/gh_mirrors/wav/wave

项目概述

H2O Wave 是一个现代化的开源框架，专为构建实时、交互式的数据科学和AI应用程序而设计。它允许开发者快速创建丰富的Web界面，同时保持后端逻辑的简洁性。

安装方式

基础安装

H2O Wave 提供了多种安装方式以适应不同的开发环境：

1. 使用pip安装（推荐大多数用户）：

   pip install h2o-wave
   

2. 使用conda安装：

   conda config --append channels conda-forge
   conda install -c h2oai h2o-wave
   

   注意：conda安装包不包含Wave服务器(waved)，需要单独运行。

虚拟环境安装（推荐）

为保持项目依赖隔离，建议在虚拟环境中安装：

Unix/MacOS系统

python3 -m venv venv
source venv/bin/activate
pip install h2o-wave

Windows系统

python -m venv venv
.\venv\Scripts\activate
pip install h2o-wave

Conda环境

conda create -n venv
conda activate venv
conda config --append channels conda-forge
conda install -c h2oai h2o-wave

项目模板初始化

安装完成后，可以使用以下命令初始化项目模板：

wave init

这将引导你选择一个预定义的应用模板，快速启动你的第一个Wave应用。

交互式学习

对于喜欢动手实践的学习者，H2O提供了Wave University应用：

1. 首先安装学习包：

   pip install h2o_wave_university
   

2. 然后启动学习应用：

   wave learn
   

示例应用获取

运行以下命令下载示例应用和演示：

wave fetch

这将下载200多个示例应用，包括演示和布局样本。

运行交互式教程

启动教程应用：

cd wave
pip install -r examples/requirements.txt
wave run --no-reload examples.tour

然后在浏览器中访问http://localhost:10101/tour即可开始交互式学习。

高级安装选项

手动下载Wave服务器

如果需要手动运行Wave服务器，可以根据操作系统下载对应的版本：

| 操作系统 | 服务器版本 | Python客户端版本 | |---------|-----------|-----------------| | Mac(Intel) | darwin-amd64 | macosx_10_9_x86_64 | | Mac(M1) | darwin-arm64 | macosx_11_0_arm64 | | Windows | windows-amd64 | win_amd64 | | Linux | linux-amd64 | manylinux1_x86_64 |

夜间构建版本

对于希望体验最新功能的开发者，可以使用每日构建的夜间版本：

1. 下载对应操作系统的.whl文件
2. 使用pip安装：

   pip install <下载的夜间版本>.whl
   

开发工具增强

为获得更好的开发体验，建议安装IDE插件：

• VSCode扩展：提供Wave特定的自动补全和代码片段
• JetBrains插件：为PyCharm等JetBrains系列IDE提供支持

运行自定义应用

运行任何Wave应用的基本命令格式为：

wave run 模块名.应用名

例如运行todo示例：

wave run examples.todo

然后访问http://localhost:10101/demo即可查看运行结果。

常见问题解决

在MacOS上运行wave fetch时可能遇到SSL证书验证错误，解决方法：

1. 导航至Application/Python 3.7目录
2. 执行Install Certificates.command脚本

通过本指南，您应该已经完成了H2O Wave的安装并准备好开始开发交互式数据应用。下一步可以探索官方文档中的教程，深入了解Wave的各种功能和组件。

wave Realtime Web Apps and Dashboards for Python and R 项目地址: https://gitcode.com/gh_mirrors/wav/wave