Installation & First Launch · Docs

System requirements

OS: macOS (Apple Silicon supported first)
Memory: 8 GB or more recommended
Network: access to your chosen model provider's API (requests go directly from your Mac)
Account: no VibeSpace account required — bring your own model API key

Download and install

Download VibeSpace_0.14.0_aarch64.dmg from the website.
Open the DMG and drag VibeSpace.app into Applications.
On first launch, if macOS warns that the developer cannot be verified (this release is an un-notarized beta), right-click the app → Open and confirm.

Note: VibeSpace is in invite-only beta; the installer is not yet signed or notarized. The public release will include signing and notarization.

First launch

Step 1: configure a model provider

Go to Settings → LLM Providers:

Pick a provider (DeepSeek, GLM, Kimi, MiniMax, Qwen, Doubao, OpenAI, Claude, Gemini, OpenRouter, or any OpenAI-compatible endpoint);
Paste your API key;
Click Test Connection, then fetch the model list and choose a default model.

Your key is encrypted on this machine only — it never enters logs and never reaches VibeSpace servers. See Model providers (BYOK).

Step 2: authorize a workspace

The first time you create a task you will pick a folder as the workspace. All file operations and commands stay inside it; a macOS security bookmark remembers the authorization for future tasks.

Step 3: run your first task

Describe your goal in plain language in New Task and hit send. We recommend starting with the first task walkthrough.

Build from source (developers)

# Requires Node >= 22, pnpm >= 10, and a Rust toolchain
git clone <repo-url> && cd VibeSpace
pnpm install
pnpm dev      # build packages + sidecar, start Tauri dev mode
pnpm build    # produce a debug .app

The product has three parts: the Tauri desktop app (React/TS front end + Rust control plane), a standalone Rust agent runtime sidecar (vibespace-runtime, talking to the app over stdio), and the bundled module package (VibeWorking).

Uninstall

Move VibeSpace.app from Applications to the Trash;
To remove local data, delete the ~/.vibespace/ folder (tasks, settings, and skills live there — export first if needed, see Data & privacy).

Installation FAQ

"Damaged / cannot verify developer": expected for the un-notarized beta. Allow the app in System Settings → Privacy & Security, or right-click and choose Open.
Test connection fails: verify the API key and that your network can reach the provider endpoint. If you need a proxy, see Settings.