xworkspace-console/README.md

3.1 KiB

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

XWorkspace Console homepage 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

  1. 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 -
  1. 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

  1. Open the console via your browser:
http://127.0.0.1:17000
  1. Or launch the local desktop console application:
./scripts/setup-xworkspace-desktop.sh

Download