Skip to main content

Quick Start Guide

Get Tabby up and running quickly with this streamlined setup guide. This focuses on the essential steps to get you started.
For a complete setup with all features, see the full installation guide.

Prerequisites

Before you begin, make sure you have:
1

Install Required Software

2

Get API Keys

At minimum, you need an OpenAI API keyOptional providers:

Installation

1. Clone and Install

2. Start Supabase

Tabby uses a local Supabase instance via Docker. Make sure Docker Desktop is running first.
The first run will download Docker images (~13 images, takes a few minutes). Subsequent starts take ~10 seconds.
After Supabase starts, it will print credentials. Save these - you’ll need:
  • API URL
  • anon key
  • service_role key

3. Configure Environment Variables

Create environment files from the examples:
Edit each file with your credentials:

4. Create Storage Buckets

You can create buckets via Supabase Studio at http://localhost:54323 → Storage, or use this PowerShell command:

Running Tabby

Start all services in separate terminal windows:
1

Terminal 1: Supabase

2

Terminal 2: Memory Backend

3

Terminal 3: Next.js Backend

4

Terminal 4: Electron App

The Windows MCP server (Terminal 5: pnpm run windows-mcp) is optional and provides additional desktop automation features.

Verify Installation

Once all services are running, you should see:
  • Supabase Studio: http://localhost:54323
  • Frontend: http://localhost:3000
  • Next.js Backend: http://localhost:3001
  • Memory API: http://localhost:8000
  • Tabby App: Running in your system tray

First Steps

1

Access the System Tray

Look for the Tabby icon in your system tray. Right-click for options:
  • Show Actions Menu
  • Brain Panel
  • Settings
  • Quit
2

Try the Action Menu

Press Ctrl+\ to open the action menu. Select some text first to see AI actions.
3

Test AI Suggestions

Press Ctrl+Space while typing to get AI suggestions for your current context.
4

Open Brain Panel

Press Ctrl+Shift+B to view the memory dashboard and see stored memories.

Essential Keyboard Shortcuts

Get started with these key shortcuts:
See the full keyboard shortcuts reference for all available commands.

Troubleshooting

If services fail to start, ensure Docker Desktop is running before starting Supabase.

Common Issues

  • Ensure Docker Desktop is running
  • Check if ports 54321-54323 are available
  • Try npx supabase stop then npx supabase start
  • Verify Python 3.12+ is installed
  • Check that uv is installed: pip install uv
  • Ensure the Supabase connection string is correct
  • Verify all environment variables are set
  • Check that ports 3000, 3001, and 8000 are available
  • Try deleting node_modules and running pnpm install again

Next Steps

Full Installation

Complete setup with optional features like Neo4j knowledge graphs

Configuration

Configure AI providers, customize shortcuts, and personalize Tabby

Keyboard Shortcuts

Learn all shortcuts to maximize productivity

Interview Copilot

Master the coding interview assistant features