Go to file

Haitao Pan d2da139e8d fix(prefetch): keep prefetched commit on a branch (Linux) prefetch_git_repository left the repo on a detached FETCH_HEAD. The dir is consumed via 'git clone file://<dest>', and a detached/unreachable commit can be pruned by git gc and is fragile to transfer, surfacing as 'unable to read tree <sha>' during the downstream console checkout. Point a local branch (ai-workspace-prefetched) at the fetched commit so it stays reachable and fully clonable.		2026-06-19 03:28:58 +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): litellm brew install via command (clone-path patch) + TC-MAC-019	2026-06-19 03:00:27 +00:00
scripts	fix(prefetch): keep prefetched commit on a branch (Linux)	2026-06-19 03:28:58 +00:00
tests	fix: refresh offline repositories on fresh hosts	2026-06-19 10:26:37 +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