GAIA — Your Personal AI Assistant

gaia.landing.page.mp4

GAIA is the open-source personal AI assistant that does the work you shouldn't be doing manually. It connects your tools, runs the repetitive work in the background, and reaches out to you — on WhatsApp, Telegram, Slack, or Discord — the moment something actually needs you. Proactive, multi-channel, and fully self-hostable.

Why GAIA?

We all drown in tools. Gmail, Calendar, Todos, Docs, Slack, Linear, WhatsApp — different stacks, same problem. Our days are eaten by small repetitive actions that are not real work. Each task feels small, but together they drain focus and energy. Over time inboxes clog, todo lists rot, and important things slip through.

Most automation doesn't fix this. Tools are rigid, built for power users, and ask you to explain your context every single time. A real personal assistant should already know you — how you write, who you work with, what you ignore. GAIA is that assistant. It remembers context across your tools, acts before you ask, and runs the repetitive work in the background while you do the real work.

Features
What you actually ask GAIA
Getting Started
- Cloud (zero setup)
- Self-host or Develop
Chat with GAIA on Your Favorite Platforms
Tech Stack
Architecture
Roadmap
Monorepo Structure
Documentation
FAQ
Community & Support
Contributing
Tools We Love
License
Contact
Star History

Features

An assistant, not a chatbot. The difference shows up in what each of these actually does.

Proactive — Acts before you ask: handles deadlines, drafts replies, flags what matters, and watches events in the background — then texts you when there's something to see
Workflows — Multi-step automations across your tools, triggered on a schedule or by an event (new email, calendar change, webhook)
Smart todos — Todos that research, draft, and execute themselves, not just reminders
Cross-tool memory — Remembers the people, projects, and preferences that come up across conversations; ask once, it sticks
One view — Tasks, email, calendar, and goals in one place, instead of five browser tabs
Integration marketplace — Connect Gmail, Calendar, Slack, Linear, Notion and more in one click — then browse a community marketplace for more, plug in any MCP server, and publish your own
Runs everywhere — Web, Desktop (macOS, Windows, Linux), Mobile
Works where you already are — Message GAIA on WhatsApp, Telegram, Slack, or Discord — and it messages you back there too, with your full context, so you never have to open another app to act
Open source & self-hostable — Full transparency, runs on your own infrastructure

_Dashboard	_{Smart Todos}
_Calendar	_{Automated Workflows}
_{Desktop App}	_{Mobile App}

What you actually ask GAIA

Real things people use GAIA for — not hypothetical features. Every example below works today.

"Summarize the 47 unread emails in my inbox and draft replies for the 3 that actually need one." GAIA ranks by importance, reads threads end-to-end, and writes drafts in your voice.
"Pull my GitHub, Linear, and Slack activity from this week and post a Friday digest to #eng-updates." Merged PRs, closed issues, channel highlights — gathered, formatted, posted.
"When my 2pm gets cancelled, rewrite my todo list to use the freed time." GAIA watches calendar changes and replans the afternoon against your pending todos and goals.
"Before my 1:1 with Alex tomorrow, brief me on everything we've shipped this sprint." Pulls related PRs, Linear issues, and Slack threads into a single prep doc.
"Turn this meeting transcript into action items, assign owners, and add them to Linear." Extracts decisions, matches them to projects, creates issues with the right assignees.
"Watch my email for anything from [investor] and ping me on Telegram within 60 seconds." Persistent background monitoring, cross-channel notification.
"Draft follow-ups to every email I sent more than 3 days ago that hasn't been replied to." Inbox sweep plus a personalised follow-up draft per thread.
"Research these 10 companies and extract their pricing, team size, and funding round into a table." Web research, structured output, pasted straight into Notion or Sheets.
"Every Monday at 9am, scan my calendar and prep a briefing for each meeting." Scheduled workflow, per-meeting context assembly, waiting for you when you sit down.

Getting Started

Cloud (zero setup)

Visit heygaia.io to get started instantly — no installation required.

Self-host (own your data)

One CLI sets up the whole stack — clone, configure, and launch every service in Docker. Prerequisites: Docker (Engine 20.10+, Compose v2+) and Node.js 20+.

# 1. Install the CLI  (pnpm add -g / bun add -g also work)
npm install -g @heygaia/cli

# 2. Clone, configure, and launch — the wizard walks you through it
gaia init        # pick "Self-Host (Docker)" when asked

# 3. Open GAIA in your browser
#    http://localhost:3000

gaia init checks your prerequisites, clones the repo, helps you fill in environment variables, then builds and starts everything in Docker. Manage it anytime:

gaia status   # health-check every service
gaia logs     # stream logs
gaia stop     # stop everything
gaia start    # bring it back up

Already cloned the repo? Run gaia setup inside it to configure an existing checkout.

Self-hosters → Self-Hosting Guide
Contributors → choose "Developer" in gaia init for hot-reload local dev, then see Developer Setup

Chat with GAIA on Your Favorite Platforms

Use GAIA directly inside the tools you're already in.

	Platform	How to Use
	WhatsApp	Message GAIA and send messages or use `/gaia` commands
	Telegram	Message @heygaia_bot and send messages or use `/gaia` commands
	Slack	Add GAIA to your workspace and use `/gaia` and other slash commands
	Discord	Add the bot or join the server — use `/gaia` or `@mention` GAIA in any channel
	iMessage	Coming soon — text GAIA right from Messages on your iPhone or Mac

See the Bot Integrations Guide for setup and usage details.

Tech Stack

GAIA is a full-stack Nx monorepo spanning web, desktop, mobile, backend, voice, and infrastructure.

Layer
Web Frontend
Desktop
Mobile
Backend
AI / Agents
Databases
Queue & Tasks
Monitoring
Bots
Infrastructure
Tooling

Roadmap

We track upcoming features, planned improvements, and in-progress work publicly.

View Roadmap · Submit a Feature Request

Monorepo Structure

This repository is a full-stack monorepo managed with Nx.

gaia
├── apps
│   ├── web              → Next.js web app                  https://heygaia.io
│   ├── desktop          → Electron desktop app (beta)      https://heygaia.io/download
│   ├── mobile           → React Native mobile app (beta)   
│   ├── api              → FastAPI + LangGraph backend
│   ├── voice-agent      → Voice processing worker
│   └── bots
│       ├── discord      → Discord bot
│       ├── slack        → Slack bot
│       └── telegram     → Telegram bot
├── docs                 → Documentation Website            https://docs.heygaia.io
├── packages
│   ├── cli              → @heygaia/cli setup tool           npm install -g @heygaia/cli
│   └── gaia-ui          → @heygaia/ui (wrapper)             https://ui.heygaia.io
├── libs
│   ├── shared
│   │   ├── py           → gaia-shared Python package (used by api, voice-agent, bots)
│   │   └── ts           → Shared TypeScript utilities
│   └── wake-word        → @gaia/wake-word — cross-platform on-device "Hey GAIA" detection
│       │                  (122 KB ONNX, web + electron + react native, ~80 ms time-to-wake)
│       ├── src/core     → platform-agnostic detector + 3-stage openWakeWord pipeline
│       ├── src/web      → onnxruntime-web + AudioWorklet + React hook
│       ├── src/native   → onnxruntime-react-native + audio capture + RN hook
│       ├── models       → bundled ONNX artifacts (mel + embedding + VAD + classifier)
│       └── training     → Python pipeline: Piper TTS synthesis + LibriSpeech negatives + MPS training
└── infra
    └── docker           → Docker Compose configs (dev + prod)

For a deeper look at how the pieces connect, see the Architecture Overview in the docs.

Documentation

Our comprehensive documentation is available at docs.heygaia.io:

Quick Start - Get up and running in minutes
Bot Integrations - Use GAIA on Discord, Slack, and Telegram
Self-Hosting - Deploy GAIA on your infrastructure
For Developers - Contribute and extend GAIA

FAQ

Cloud vs self-hosted — what's different for me as a user?

The interface is identical on both. Cloud is zero-setup at heygaia.io, free to start, with plan-based usage limits and managed infrastructure. Self-hosting gives you full data control, no usage caps, and the ability to swap models freely — in exchange for running the stack on your own machines and bringing your own API keys.

How do I connect a new integration?

Open /integrations. Browse by category (Productivity, Communication, Developer, and more) or search by name. Click Connect — for providers like Gmail, Calendar, Slack, Linear or Notion, you'll be redirected to their consent screen to grant the scopes GAIA needs; for API-key providers, a modal pops up where you paste the token. Once connected, the sidebar shows the tools that integration unlocks, and a Disconnect button revokes access in one click.

Need something that isn't in the catalogue? You can add your own MCP integration from the same page, connect it privately, or publish it to the community marketplace.

Does GAIA read my email?

Only the threads relevant to whatever you've asked it to do, and only with the scopes you granted on the provider's OAuth consent screen when you connected Gmail. Email content isn't mirrored into GAIA's database — it's fetched per request. You can disconnect the integration from /integrations at any time, which revokes access immediately.

What data does GAIA store about me, and can I delete it?

Yes, all of it is under your control:

Long-term memory — everything GAIA has learned about you (people, projects, preferences) is visible on the Memory settings page as a list or interactive graph. Delete individual memories, or clear everything with one button. You can also export your memory graph as PNG or SVG.
Chat history — the Preferences settings page has a one-click "Clear chat history".
Workflows, todos, and reminders — all manageable from their respective pages.
Integration tokens — stored encrypted, revoked immediately when you disconnect.

Integration content (email bodies, calendar events, documents) is not persisted — it's fetched on demand when a request needs it.

How does GAIA's "proactive" behaviour actually work?

Head to the Workflows page and build one. Two kinds of triggers today:

Scheduled — cron-style ("every weekday at 9am", "first Monday of the month")
Event-driven — new Gmail message, new calendar event, webhooks from Linear / Slack / GitHub / Todoist / Sheets / Docs

Chain steps across your integrations ("fetch → summarise → post to Slack") and GAIA will run the whole thing in the background, no prompt required. When a run produces something you should see — a drafted email, a new todo, a reminder, a suggested calendar event — it lands in the notifications bell in the header and on the /notifications page, where you can approve, edit or dismiss it.

Can I bring my own API keys?

On self-hosted, yes — provider keys (model providers, integration services) are configured via environment variables. On cloud, no — the platform manages models on your behalf and usage is governed by your plan. You can still pick between the available models from the chat composer; which ones are unlocked depends on your plan.

What does self-hosting cost to run?

The GAIA code is free under Polyform Strict (noncommercial use). Real costs are: model API usage (scales with how much you use it), any paid-tier integration services you opt into, and hosting — a single modestly-sized VM handles a small team. See the self-hosting guide for detailed numbers.

Community & Support

Join our growing community of users and contributors:

Discord — Chat with the team and other users.
Twitter — Get the latest news and updates.
WhatsApp — Get direct support from our team.

Contributing

We welcome contributions of all kinds — bug fixes, features, docs, and tests.

🤖 AI & vibe-coded PRs are welcome! Built it with Claude, Cursor, or any AI tool? That's great — just mention it in the PR description.

Where to start:

Contributing Guidelines — how we work and what we're looking for
Development Setup — get your local environment running
Code Style Guide — linting, formatting, and conventions
Conventional Commits — commit message format
Pull Request Guide — how to open a great PR

For bugs and feature requests, open an issue.

Tools We Love

GAIA is built on the shoulders of giants — the language models, frameworks, and open-source projects that make this possible. Full credits at heygaia.io/thanks.

License

This project is licensed under the Polyform Strict License 1.0.0.

Warning

This license allows noncommercial use only.

See the full license terms at LICENSE.md.

Contact

Feel free to contact the team at contact@heygaia.io or aryan@heygaia.io for any questions

Star History

If GAIA could save you even an hour a week, consider giving it a ⭐ — it helps more people find the project and keeps us building in the open.

Made with ❤️ by heygaia.io • Documentation • Contact Us

gaia