hub 的安装和配置教程

项目基础介绍

hub 是一个集成了人工智能的设备中心，它允许用户使用自然语言与物理设备进行交互，比如通过大型语言模型主机（如 Claude Desktop 或 Cursor）控制安全摄像头、温度计等。hub 作为 AI 与物理世界之间的网关，为用户提供了一个无缝的交互体验。

该项目的主要编程语言是 Go，同时也使用了 TinyGo 和 htmx。

项目使用的关键技术和框架

• Model Context Protocol (MCP): 这是一个允许 hub 与大型语言模型主机进行通信的协议。
• Docker: 用于容器化 hub，便于在任何支持 Docker 的环境中部署。
• Go/TinyGo: 用于编写 hub 的后端逻辑，TinyGo 是 Go 的一个分支，专为微控制器优化。
• htmx: 用于构建 hub 的前端用户界面。

项目安装和配置的准备工作

在开始安装 hub 之前，您需要做一些准备工作：

1. 确保您的系统中已经安装了 Docker。如果尚未安装，您可以从 Docker 官网下载并安装适合您操作系统的版本。
2. 准备一个支持 SSH 的服务器或者本地机器，用于运行 hub。
3. 确认您有权限在目标机器上执行命令，最好是具有 sudo 权限的用户。

安装步骤

以下是详细的 hub 安装步骤：

通过 Docker 安装

1. 打开终端（在 Windows 上是命令提示符或 PowerShell）。

2. 运行以下命令以拉取 merliot/hub 的 Docker 镜像并启动容器：

   sudo docker run -p 8000:8000 merliot/hub
   

   这条命令会将容器的 8000 端口映射到您主机上的 8000 端口。

3. 在浏览器中访问 http://localhost:8000，您应该能够看到 hub 的用户界面。

从源代码安装

1. 克隆 GitHub 仓库到您的机器上：

   git clone https://github.com/merliot/hub.git
   

2. 切换到克隆的目录：

   cd hub
   

3. 运行以下命令来编译并启动 hub：

   go run ./cmd
   

4. 在浏览器中访问 http://localhost:8000，您应该能够看到 hub 的用户界面。

完成以上步骤后，您就成功安装了 hub，并且可以开始探索它的功能了。