Skip to main content

​
Get Started in Minutes

This guide will help you start using GAIA immediately. Choose your preferred method below.

Use GAIA Cloud

Fastest way - no installation required

Self-Host GAIA

Full control with Docker deployment

​
Cloud Setup

The fastest way to start using GAIA is through our cloud platform.
1

Create Your Account

Visit heygaia.io and sign up with your email or social login.
No credit card required to get started!
2

Connect Your First Integration

GAIA becomes more powerful when connected to your tools. Start with Gmail or Calendar:
  1. Navigate to Settings → Integrations
  2. Click Connect next to Gmail or Google Calendar
  3. Authorize GAIA to access your account
You can add more integrations later like Notion, Slack, Linear, GitHub, and hundreds more!
3

Have Your First Conversation

Start chatting with GAIA to see what it can do:Try asking:
  • “Summarize my unread emails from today”
  • “What’s on my calendar this week?”
  • “Create a todo to review the quarterly report by Friday”
  • “Schedule a meeting with Sarah for next Tuesday at 2pm”
4

Create Your First Workflow

Automate repetitive tasks with workflows:
  1. Click Workflows in the sidebar
  2. Browse the workflow marketplace for templates
  3. Click Use Template on any workflow
  4. Customize it to your needs
  5. Activate it
Popular starter workflows:
  • Daily email digest every morning
  • Automatic meeting notes from calendar events
  • Weekly task summary and planning

​
Download Desktop & Mobile Apps

Get GAIA on all your devices for seamless productivity:

macOS

Download from heygaia.io/download

Windows

Download from heygaia.io/download

Linux

Download from heygaia.io/download

​
Self-Hosting

Deploy GAIA on your own infrastructure for complete control and data privacy.
1

Prerequisites

Ensure you have these installed:
  • Docker and Docker Compose
  • Git
  • 4GB+ RAM available
  • PostgreSQL, MongoDB, Redis (or use Docker Compose)
2

Clone the Repository

git clone https://github.com/theexperiencecompany/gaia.git
cd gaia
3

Configure Environment Variables

Copy the example environment files and configure them:
# API configuration
cp apps/api/.env.example apps/api/.env

# Web app configuration  
cp apps/web/.env.example apps/web/.env.local
You’ll need to configure:
  • Database connection strings
  • API keys for LLM providers (OpenAI, Anthropic, etc.)
  • OAuth credentials for integrations
See the Self-Hosting Guide for detailed configuration.
4

Start with Docker Compose

Launch all services with Docker Compose:
cd infra/docker
docker compose up
This starts:
  • FastAPI backend (port 8000)
  • Next.js web app (port 3000)
  • PostgreSQL database
  • MongoDB
  • Redis
  • ChromaDB for vector storage
  • RabbitMQ message broker
Use profiles to start specific components:
# Backend only
docker compose --profile backend up

# Worker only
docker compose --profile worker up
5

Access GAIA

Open your browser and navigate to:Create your first account and start using GAIA!

​
Development Setup

Contributing to GAIA or want to run from source?
1

Install Dependencies

GAIA uses pnpm for JavaScript and uv for Python:
# Install Node dependencies
pnpm install

# Sync Python dependencies for API
nx run api:sync
2

Run Development Servers

Start the development servers:
# Run web app (with Turbopack)
nx dev web

# Run API backend (with hot reload)
nx dev api

# Run background worker
nx worker api
3

Access the Application

​
What’s Next?

Explore Features

Learn about GAIA’s powerful capabilities

Browse Use Cases

See how others are using GAIA

Connect Integrations

Connect your favorite tools

Join Community

Get help and share ideas

​
Need Help?

If you run into any issues:

Build docs developers (and LLMs) love

Get started for freeTalk to us