octo-web

一套代码搞定浏览器和桌面，原生拥抱 AI 智能体的工作空间客户端

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署 智能体 🍴 复刻 187 🐛 待处理 10 👀 关注 121
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 1213
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源项目，Apache-2.0 许可证，可自由使用和部署，无付费版本。

项目预览

octo-web 项目界面预览图
图片来源：GitHub 官方仓库名片

项目数据

分类智能体
开发团队Mininglamp-OSS
官网地址https://github.com/Mininglamp-OSS
GitHubhttps://github.com/Mininglamp-OSS/octo-web
定价模式🏷️完全免费
价格说明开源项目，Apache-2.0 许可证，可自由使用和部署，无付费版本。
访问状态🔧 仅开源项目，无在线服务，需自行部署
是否开源是
开源协议Apache-2.0
主要语言TypeScript
技术栈/模型ai-agent,chat,desktop-app,electron,i18n,im,messaging,monorepo,open-source,pwa,react,turborepo,typescript,websocket
GitHub 星标★ 1213
上线时间2026-05-11 00:00:00
代码更新2026-11-06
仓库体积49.7 MB
本站数据更新2026-11-07
维护状态活跃
收录时间2026-08-09
浏览次数5

项目介绍

octo-web 是 OCTO 开放工作空间的官方客户端，采用 React + TypeScript 构建，一套代码同时支持浏览器（PWA）和桌面（Electron）双端。项目定位为面向 AI 智能体时代的工作沟通工具，内置聊天、消息、工作区管理等基础 IM 能力，并通过 WebSocket 实现实时通信。其核心特色在于将 AI 智能体作为一等公民融入交互界面，提供专门的智能体操作体验，而非简单的聊天机器人挂载。项目采用 monorepo + Turborepo 管理，支持国际化（i18n），技术栈现代。当前处于早期阶段（600+ 星标），旨在为 OCTO 生态提供统一的前端入口，解决传统工作空间工具缺乏 AI 原生协作体验的问题。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1213

使用教程

难度：入门 约 10 分钟 部署方式：本地安装 5 步

环境要求

  • 已安装 Node.js（README 未指定具体版本，建议使用较新的 LTS）
  • 已安装 pnpm 包管理器（README 中全部命令均使用 pnpm）
  • 一个可访问的 octo-server 实例，默认地址为 http://localhost:8080
  • 网络可访问 GitHub 以克隆仓库

安装与启动步骤

  1. 1克隆仓库

    从 GitHub 拉取 octo-web 源码到本地，确保网络可访问 GitHub。

    git clone https://github.com/Mininglamp-OSS/octo-web.git

  2. 2进入项目目录

    切换到刚克隆下来的 octo-web 目录，后续命令都在此执行。

    cd octo-web

  3. 3安装依赖

    用 pnpm 安装 monorepo 全部依赖，依赖较多时耗时较长，请耐心等待。

    pnpm install

  4. 4配置服务端地址

    复制环境变量示例文件，编辑其中的 VITE_API_* 指向你自己的 octo-server 地址。

    cp .env.example .env.local

  5. 5启动开发服务

    运行 dev 脚本启动浏览器端开发服务，终端会输出本地访问地址。

    pnpm dev

关键配置

配置项必填说明示例
VITE_API_*否指向 octo-server 的接口地址，默认使用 http://localhost:8080。http://localhost:8080

如何确认成功

pnpm dev 启动后终端会打印本地访问地址，浏览器打开该地址并能连上 octo-server 即成功。

常见问题

Q：前端启动后连不上后端、消息加载不出来怎么办？

A：确认 octo-server 已运行且在 http://localhost:8080 可访问；若不是该地址，请在 .env.local 中修改 VITE_API_* 指向你自己的服务端。

Q：可以用 npm 或 yarn 代替 pnpm 吗？

A：README 的 Quickstart 全部使用 pnpm 命令（pnpm install / pnpm dev），建议直接使用 pnpm 以免依赖安装出现差异。

Q：是否支持桌面 PC 客户端？

A：支持。浏览器版与 Electron 桌面版由同一份 src/ 代码构建，属于同一代码库的两个发布形态。

Q：需要单独申请密钥或账号吗？

A：README 未提及任何密钥或账号要求，仅需准备可访问的 octo-server 实例即可。

注意事项

  • README 未指定 Node.js 与 pnpm 的具体版本要求，建议使用较新的稳定版本。
  • octo-web 只是前端，必须配合 octo-server 才能完整使用聊天与实时通信功能。
  • .env.local 为你本地的服务端配置，读取示例文件后按需修改，不要直接改动 .env.example。

核心亮点

  • React + TypeScript 单代码库同时输出 PWA 和 Electron，开发维护成本低
  • 将 AI 智能体作为一等公民融入 UI，而非简单聊天框，交互设计更原生
  • 基于 WebSocket 实时通信，适合即时消息和协作场景

不足之处

  • 早期项目，文档和社区生态待观察
  • 功能聚焦于 OCTO 平台，脱离该生态可能无法独立使用

适用场景

  • 作为 OCTO 工作空间的桌面端和 Web 端统一入口
  • 在团队协作中集成 AI 智能体辅助任务处理
  • 作为 React + Electron 跨端开发的参考实现

替代项目

Rocket.Chat、Mattermost、Zulip

上一篇：loom

下一篇：tgo

同类项目推荐

Meldwork 开源

本地跑多智能体协作，权限可控、过程可查、关键处人工拍板

Local-first AI agent workspace for multi-agent collaboration, agent orchestration, s···

★ 1462 2026-10-19
Awesome-Agentic-System-Design 开源

一页看懂智能体系统设计全貌，少走弯路

A curated collection of resources, frameworks, papers, and best practices for design···

★ 138 2026-10-10
Claude-Code-Game-Master 开源

把任何书变成你的RPG冒险世界，用Claude Code玩出沉浸剧情。

Total conversion for Claude Code. Use RAG and the RPG ruleset apis to play a persist···

★ 161 2026-08-09
semantix 开源

给智能体装个高效大脑，越用越聪明

semantic agent kernel which make agent efficient and self-evolve

★ 811 2026-09-16
tinyhumans 开源

在微型沙盒里，创造和互动小人物的故事

A little interactive sandbox for tiny people, tiny thoughts, and their tiny stories

★ 129 2026-08-09
pew-pew-plaza-packs 开源

模块化搭建 AI 智能体，让提示词工程更高效

AI-powered project management framework based on an opinionated view on effective pr···

★ 87 2026-08-09
maestro-orchestrate 开源

让多个 AI 编码助手协作，自动完成复杂开发任务并提升代码质量。

Multi-agent orchestration platform for Gemini CLI, Claude Code, Codex, and Qwen Code···

★ 486 2026-08-09
vendo 开源

把 AI 智能体嵌入你的产品，让用户用对话搞定自动化

Embedded agents your customers use to automate work, build views, and connect their ···

★ 636 2026-08-09