The common role's 'Base | *' tasks (timedatectl timezone, /etc/hostname, hostname, /etc/hosts, ssh hardening, fail2ban, file limits, firewall) all run with become: true against Linux-only tooling/paths and fail on macOS — the reported timedatectl failure is just the first. Add patch_playbook_common_macos() (post-clone, Darwin-only) that appends an ansible_os_family != 'Darwin' guard to the whole Base block. Idempotent; verified against the real role; Linux unchanged. Documents TC-MAC-014. |
||
|---|---|---|
| .github/workflows | ||
| api | ||
| assets/readme | ||
| config | ||
| dashboard | ||
| docs | ||
| scripts | ||
| tests | ||
| .gitignore | ||
| LICENSE | ||
| 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/, anddocs/
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
