mrkeyoor.com_
Sat 17 Oct 13:35 UTC
Webevaluationupdated 26 Aug 2026

octo-web review

OCTO Web is the browser and Electron desktop client for the OCTO messaging platform. It combines human chat, channels, files, and interfaces for AI agents in one React and TypeScript codebase, but it needs the separate OCTO server to function.

+21stars / 7d
Verdict

Our OCTO Web install consumed 1,178 MB, then both the 8-second build and 10-second test steps failed, so this checkout is a risky foundation unless your team can trace a large pnpm monorepo. The product idea suits an organization already committed to OCTO's server and agent model. For a general self-hosted chat deployment, choose a platform whose basic build passes in your target environment before accepting this client's ecosystem and debugging cost.

We ran it

Lab card: what happened when we ran octo-webScreenshot of octo-web (github.com/Mininglamp-OSS)
Install✓ · 92s1870 packages · 1178 MB
Build✗ · 8s
Tests✗ · 10sran, no count parsed
Repo3447 files~354,079 lines of source · 41.4 MB · 23 CI workflows · Dockerfile

Answers from our run

Does octo-web build from source?

Dependencies installed in 92 seconds (1870 packages), and the build failed. We cloned commit aead41c into a clean Debian container with 3 CPUs and no project-specific setup.

Do octo-web's tests pass?

No. The project's own test command exited unsuccessfully after 10 seconds, and its output did not expose an individual test count.

Who should not use octo-web?

Anyone looking for a standalone chat application: the README says the client expects octo-server at http://localhost:8080, and several features belong to other OCTO repositories.

What are the alternatives to octo-web?

Mattermost, Rocket.Chat, Zulip. Our OCTO Web install consumed 1,178 MB, then both the 8-second build and 10-second test steps failed, so this checkout is a risky foundation unless your team can trace a large pnpm monorepo.

Setup1/51,178 MB install; build and tests both failed in our sandbox
Docs3/5Quick start is clear, but the wider service setup is distributed
Community4/5Pushed August 2026 with 72 combined open issues and PRs
Maturity2/5v1.14.0 is active, but core checkout checks did not pass

Who it’s for

Teams evaluating OCTO as a self-hosted workplace with browser and desktop clients.
React developers who need to change chat, channel, file, settings, or AI-agent interfaces in the OCTO ecosystem.
Organizations willing to operate a separate messaging server and coordinate web changes with its REST and WebSocket contracts.
English and Simplified Chinese workplaces that want both languages in the same client.

Who it’s NOT for

Anyone looking for a standalone chat application: the README says the client expects octo-server at http://localhost:8080, and several features belong to other OCTO repositories.
Small teams wanting a light front-end dependency tree: our install pulled 1,870 packages, consumed 1,178 MB, and still did not produce a passing build or test run.
Buyers who need a proven clean checkout today: the build failed with 0 of 2 tasks successful, while the test summary listed failures across web, mail, contacts, login, datasource, MCP, and other workspaces.
File-heavy workplaces that need every large directory visible now: open issue 1325 says the current drive view fetches 200 items and that full pagination depends on a backend sorting change.
Users relying on zip uploads without their own acceptance test: open issue 1312 reports failed zip uploads and a broken-looking failure state.

Setup reality

Our sandbox installed 1,870 packages in 92 seconds and used 1,178 MB on disk. The build failed with exit 1 after 8 seconds, reporting 0 successful tasks out of 2 and naming @octo/web#build. Tests also failed with exit 1 after 10 seconds across several workspaces.

Running the interface needs pnpm, an octo-server endpoint, and local VITE_API_* configuration. The default server address is http://localhost:8080; Electron packaging adds platform-specific desktop work, and the wider workplace spans separate server, task, summary, admin, mobile, library, and adapter repositories.

The monorepo accepts Node 18 or newer and pins pnpm 10.32.0 in its package metadata. Our supplied build tail printed Node 18.20.8 even though the sandbox image was lab-node:22; the log does not explain that detail, so reproduce the toolchain before diagnosing the failure.

One React client ships to browsers and Electron desktops

OCTO Web is the user-facing client for a broader workplace system. The same React application runs in a browser and inside an Electron shell, with platform branches reserved for native capabilities such as tray behavior, notifications, file dropping, and updates. Its main screens cover chats, channels, organizations, settings, files, and agent interactions. Streaming replies, tool-call previews, identity labels, and read receipts treat AI participants as ordinary parts of a conversation rather than a separate chatbot page.

The repository is far larger than the name suggests. Our checkout contained 3,447 files, about 354,079 source lines, and 41.4 MB before installed dependencies. It is a pnpm workspace monorepo with packages for several product areas, not one small Vite application. English and Simplified Chinese resources ship together, while the README and main project explanation are available in English. Apache-2.0 licensing permits internal modification and redistribution under its terms.

The client requires OCTO Server on port 8080

The quick start runs the front end, but a useful session depends on a separate backend. By default, the browser expects octo-server at http://localhost:8080 over REST and WebSocket. A local environment file changes the VITE_API_* values. That means a successful development server is only the shell of the product; login, messages, presence, files, and agents need compatible server behavior and data behind it.

The README maps 9 repositories across web, Android, iOS, server, tasks, summaries, administration, shared Go code, and adapters. A team adopting the complete workplace must version those parts together and understand which service owns a failure. The web client alone does not provide accounts, storage, or agent execution. Electron adds another release path for macOS, Windows, and Linux, so desktop signing, updates, and native packaging sit beyond the browser build.

What happened when we ran it

Our sandbox installed 1,870 packages in 92 seconds, leaving 1,178 MB on disk. The build then failed with exit code 1 after 8 seconds. Its tail named @octo/web#build, reported 0 successful tasks out of 2, and ended in pnpm lifecycle errors. The repository had 23 CI workflow files and a Dockerfile, which shows substantial automation exists, but neither signal changes the result from commit aead41c on our clean machine.

Tests failed with exit code 1 after 10 seconds. The summary listed failing commands for @octo/base, @octo/web, @octo/contacts, @octo/mail, @octo/datasource, @octo/login, @dmwork/mcp, @dmwork/summary, and @dmwork/skillmarket. The supplied tail does not include the earlier errors that triggered those lifecycle failures, so assigning a root cause would be guesswork. The defensible finding is that neither top-level quality command passed in the stated sandbox.

The package metadata accepts Node 18 or newer and pins pnpm 10.32.0. Curiously, the build tail printed Node 18.20.8 although the supplied sandbox image was lab-node:22. That observation is not an explanation for the failure. A prospective contributor should first capture the resolved Node and pnpm paths, then rerun the failing workspace command with its full log. With 1,870 installed packages, toolchain drift and workspace-specific scripts deserve explicit checks.

Drive folders stop at 200 items pending server work

Open issue 1325 documents a practical limit in the cloud-drive interface. The current behavior makes one fetch with a page size of 200 and tells users when the displayed set is truncated. Completing infinite scrolling depends on a new backend ordering contract and index, not only a React hook. The issue also describes races among reload, load-more, retry, filter, and context changes. Organizations planning large shared directories should treat full browsing as unfinished until both client and server changes land.

Another open report, issue 1312, says zip uploads fail and leave a red failure card with a truncated filename. Issue 1313 asks for image previews to remain in the site instead of opening a new tab and to support galleries. These reports are specific rather than fatal, but they expose how much product surface the client carries. Messaging may be the center, yet file transfer and preview behavior will influence whether users can replace their existing workplace tool.

August 2026 activity is high, while stability is still moving

Version 1.14.0 was published on August 24, 2026, and the repository was pushed again on August 26. GitHub reported 884 stars and 72 combined open issues and pull requests. The release includes desktop packaging fixes, settings work, mail changes, summary-contract updates, chat behavior, voice input, and test infrastructure. That volume shows active engineering. It also means adopters should expect contracts and product details to change across several modules at once.

OCTO Web makes the most sense as one part of an OCTO decision, never as an isolated React component. The dual browser and desktop codebase avoids maintaining two front ends, and the agent conversation model is more integrated than a bolt-on assistant panel. Our failed build and broad test failure keep it out of the low-risk category. Prove the exact server revision, toolchain, login flow, message path, and file workflow on your infrastructure before asking users to depend on it.

Alternatives

ProjectWhat it isPick it when
Mattermost gh↗A self-hosted collaboration platform centered on channels and operational workflows.pick this instead when you want a more established team-chat product and OCTO's agent interfaces are not the deciding feature.
Rocket.Chat gh↗A self-hosted communications platform with web, mobile, and integration options.pick this instead when broad communications deployment matters more than OCTO's shared human and agent workspace.
Zulip gh↗A self-hosted team chat organized around topic-based conversation threads.pick this instead when long-running, organized discussion is the main job and AI-agent surfaces are secondary.

What people are saying

  1. [github-trending] Mininglamp-OSS/octo-web

Sources

  1. OCTO Web README
  2. OCTO Web repository facts
  3. OCTO Web v1.14.0 release
  4. Drive pagination issue 1325
  5. Zip upload issue 1312

More web reviews

dioramas · elpis · deepseek-whale-girl · floorplan-3d · taro · driver.js · the whole board →