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:

Choose one of the 28 connection options: a model provider, aggregation or inference platform, cloud service, or custom OpenAI-compatible endpoint;
Enter the API Key (Spark uses an API Password) and any required Base URL;
Enter a model ID or deployment name when required, then click Test Connection. If model discovery is supported, choose from the returned list; otherwise use a manually entered model ID. Save the connection.

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.