Go to file

Haitao Pan d3356a0ef0 docs(operations): end-to-end IaC<->Ansible dynamic-inventory workflow Documents the YAML->generate.py->terraform->cmdb.json->ansible flow, the FQDN inventory_hostname contract, the two execution models, the Vault-OIDC pipeline, the non-empty/fail-fast checks, and the key fixes that make it work end to end. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>		2026-06-24 20:51:54 +08:00
.github/workflows	ci(deploy-iac): fail fast on missing required Vault secrets	2026-06-24 20:46:30 +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	feat(dashboard): enforce token authentication by default and always enable logout	2026-06-22 15:14:44 +08:00
docs	docs(operations): end-to-end IaC<->Ansible dynamic-inventory workflow	2026-06-24 20:51:54 +08:00
scripts	fix(bootstrap): inventory_hostname from FQDN, not hardcoded 127.0.0.1	2026-06-24 20:42:27 +08:00
tests	fix: refresh offline repositories on fresh hosts	2026-06-19 10:26:37 +08:00
.gitignore	chore(macos-patch): resilient litellm install + idempotent OpenClaw guards	2026-06-22 13:25:12 +08:00
LICENSE	Initial commit	2026-06-06 17:45:23 +08:00
README.md	Update README.md	2026-06-23 14:53:35 +08:00
README.zh.md	Fix model names in registration instructions	2026-06-23 14:52:04 +08:00

README.md

🇺🇸 English | 🇨🇳 中文

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

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 NIM、Ollama Cloud) 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 -

Offline installation:

Use a pre-downloaded deployment package by specifying its file path:

export AI_WORKSPACE_OFFLINE_PACKAGE="/path/to/offline-package.tar.gz"
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/en/OFFLINE_AI_WORKSPACE_INSTALLER.md