Go to file

Haitao Pan 87bf91d655 fix(macos): use native PostgreSQL mode on Darwin (Linux keeps compose) postgresql_deploy_mode defaults to compose (Docker) and the admin password is generated via a /root password-file lookup, both of which fail on a native macOS deploy (no Docker, /root not writable). The role already ships a native path (macos.yml, Homebrew postgresql@16). In the script's Darwin block, set postgresql_deploy_mode=native and pass postgresql_admin_password directly (highest-precedence extra-var, bypassing the /root lookup). Linux unchanged. Documents TC-MAC-017.		2026-06-18 12:47:41 +00:00
.github/workflows	fix: delete existing offline release assets before upload	2026-06-18 18:05:24 +08:00
api	feat(ai): parameterize LiteLLM URL and models, cascade auth token rotation to openclaw.json	2026-06-17 06:45:13 +08:00
assets/readme	docs: add homepage screenshot to readme	2026-06-15 14:26:22 +08:00
config	feat: configure portal services and terminal	2026-06-14 08:43:53 +08:00
dashboard	style(ui): update reset auth token button to solid red button with translated hover tooltip	2026-06-17 09:15:13 +08:00
docs	fix(macos): use native PostgreSQL mode on Darwin (Linux keeps compose)	2026-06-18 12:47:41 +00:00
scripts	fix(macos): use native PostgreSQL mode on Darwin (Linux keeps compose)	2026-06-18 12:47:41 +00:00
tests	fix: support Debian 13 offline bootstrap	2026-06-18 18:08:16 +08:00
.gitignore	feat: wire dashboard to live runtime status	2026-06-13 07:41:47 +08:00
LICENSE	Initial commit	2026-06-06 17:45:23 +08:00
README.md	feat: full macOS (Darwin) compatibility fixes for setup scripts	2026-06-18 16:26:44 +08:00

README.md

XWorkspace Console

XWorkspace Console is the local AI workspace control plane for AI Workspace Lab. It brings together a React dashboard, Go status API, systemd user services, and XFCE desktop templates into one tabbed surface for services, runtime, terminal access, and workspace navigation.

Preview

Image / Video

Image and video workflows fit naturally as custom tabs inside the same console shell. This keeps artifact review, service switching, and runtime operations in one place instead of scattering them across separate apps.

About

Single entry point for the workspace UI at http://127.0.0.1:17000
Tab-first console for Workspace, services, runtime, and embedded tools
Designed to coordinate local AI services, gateway access, and desktop bootstrap flows
Backed by dashboard/, api/, config/, scripts/, and docs/

Start TLDR

Note: Currently supports macOS, Debian, and Ubuntu. Other systems are untested.

Installation

Start the all-in-one installer:

curl -sfL https://raw.githubusercontent.com/ai-workspace-lab/xworkspace-console/main/scripts/setup-ai-workspace-all-in-one.sh | bash -

Automatic model registration (via API Keys):

Exporting keys before running the installer automatically registers models (e.g., DeepSeek, NVIDIA, OLLAMA/GLM) in the gateway:

export DEEPSEEK_API_KEY="sk-..."
export NVIDIA_API_KEY="nvapi-..."
export OLLAMA_API_KEY="your-key-here"

curl -sfL https://raw.githubusercontent.com/ai-workspace-lab/xworkspace-console/main/scripts/setup-ai-workspace-all-in-one.sh | bash -

Uninstallation

# Standard uninstall (keeps configurations and states)
curl -sfL https://raw.githubusercontent.com/ai-workspace-lab/xworkspace-console/main/scripts/setup-ai-workspace-all-in-one.sh | bash -s -- uninstall

# Purge (removes all data, keys, and configurations)
curl -sfL https://raw.githubusercontent.com/ai-workspace-lab/xworkspace-console/main/scripts/setup-ai-workspace-all-in-one.sh | bash -s -- uninstall --purge

Usage

Open the console via your browser:

http://127.0.0.1:17000

Or launch the local desktop console application:

./scripts/setup-xworkspace-desktop.sh

Download

Latest source: GitHub repository
Releases: GitHub Releases
Bootstrap script: scripts/setup-ai-workspace-all-in-one.sh
Offline installer docs: docs/OFFLINE_AI_WORKSPACE_INSTALLER.md