Skip to main content

​
Quick Start

Get Wovly running and connected to your first integration in just a few minutes.

​
Prerequisites

Before you begin, make sure you have:
  • Node.js 18+ - Download from nodejs.org
  • Git - Download from git-scm.com
  • macOS, Windows, or Linux
  • An API key for at least one LLM provider (Anthropic, OpenAI, or Google)

​
Step 1: Clone and Install

Open your terminal and run: 
# Clone the repository
git clone https://github.com/wovly/wovly.git
cd wovly

# Install dependencies
npm install

# Start the application
npm run dev
The first run may take a moment while dependencies are compiled. The app window will open automatically when ready.

​
Step 2: Create an Account

When Wovly opens:
  1. Click Create Account
  2. Enter a username and password
  3. This creates a local profile on your machine (no cloud account needed)
All data is stored locally on your device. Your credentials are never sent to any server.

​
Step 3: Configure LLM Provider

Wovly needs an LLM (Large Language Model) to power its AI capabilities:
  1. Go to Settings (gear icon in sidebar)
  2. Under AI Providers, enter your API key for one of:
Claude Sonnet is recommended for the best balance of capability and speed.

​
Step 4: Connect Your First Integration

Go to the Integrations page (plug icon in sidebar) and connect at least one platform:

​
Google Workspace (Gmail + Calendar)

  1. Click Connect on Google Workspace
  2. Enter your Google Cloud OAuth credentials (see Google Workspace setup)
  3. Sign in with your Google account
  4. Grant permissions for Gmail and Calendar access

​
Slack

  1. Click Connect on Slack
  2. Follow the setup wizard to create a Slack app
  3. Authorize Wovly to send messages as you

​
iMessage (macOS only)

  1. Click Enable on iMessage
  2. Grant Full Disk Access in System Preferences → Privacy & Security
  3. Grant Contacts access when prompted

​
Step 5: Start Chatting

You’re ready! Try these example requests: 
"What's on my calendar today?"

"Email [email protected] about the meeting next week"

"Text Sarah happy birthday"

"Remind me to take my vitamins at 9am daily"

​
Development Commands

# Start in development mode (hot reload)
npm run dev

# Build for production
npm run build

# Run linter
npm run lint

​
What’s Next?

Learn About Tasks

Create autonomous workflows that run in the background

Create Skills

Build custom templates and procedures

Connect More Platforms

Add Discord, Telegram, Notion, and more

Explore Features

Discover everything Wovly can do

​
Troubleshooting

Make sure you have Node.js 18+ installed. Run node --version to check.
Check the terminal for errors. You may need to install additional dependencies for Electron on Linux.
Ensure Full Disk Access is granted in System Preferences → Privacy & Security → Full Disk Access.