GAIA is the personal AI assistant that does the work you shouldn't be doing manually — email triage, meeting prep, cross-tool workflows, and everything that quietly eats your day.
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
- 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
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
- 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 catalogue — Gmail, Calendar, Slack, Linear, Notion, and more — plus a community marketplace and custom MCP servers
- Runs everywhere — Web, Desktop (macOS, Windows, Linux), Mobile
- Chat from anywhere — Ping GAIA on Discord, Slack, Telegram, or WhatsApp — it arrives with your full context
- Open source & self-hostable — Full transparency, runs on your own infrastructure
Dashboard |
Smart Todos |
Calendar |
Automated Workflows |
Desktop App |
Mobile App |
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.
Visit heygaia.io to get started instantly — no installation required.
Prerequisites: Node.js 20+, one package manager (npm/pnpm/bun), Docker
Start with the CLI — it handles setup for both self-hosters and local dev:
npm install -g @heygaia/cli
# or
pnpm add -g @heygaia/cli
# or
bun add -g @heygaia/cli
gaia initgaia init will ask whether you want a production deployment or a local dev environment and configure everything accordingly.
- Self-hosters → Self-Hosting Guide
- Contributors → Developer Setup
Use GAIA directly inside the tools you're already in.
| Platform | How to Use | |
|---|---|---|
 |
Discord | Add the bot or join the server — use /gaia or @mention GAIA in any channel |
 |
Slack | Add GAIA to your workspace and use /gaia and other slash commands |
 |
Telegram | Message @heygaia_bot and send messages or use /gaia commands |
 |
Message GAIA and send messages or use /gaia commands |
See the Bot Integrations Guide for setup and usage details.
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 |       |
We track upcoming features, planned improvements, and in-progress work publicly.
View Roadmap · Submit a Feature Request
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.
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
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.
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.
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.
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.
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.
Feel free to contact the team at contact@heygaia.io or aryan@heygaia.io for any questions
Made with ❤️ by
