GAIA - Your Personal AI Assistant

GAIA is your proactive, personal AI assistant designed to increase your productivity.

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. Creating events, drafting emails, managing todos, reading useless messages. This is not real work. It is maintenance. Each task feels small, but together they drain focus and energy. Over time inboxes clog, todo lists rot, messages pile up, and important things slip through. This constant noise burns people out and pushes them into work they hate, not because the work is meaningless, but because their mental bandwidth is gone. This is how it started for us. We missed a time sensitive email because everything looked urgent and we were already exhausted.

Automation should solve this, but it does not. Most tools are rigid and built for power users. Even with LLMs, the burden stays on the user. You still explain context, preferences, and writing style again and again. That is wasted effort. A real personal assistant should already know you. It should understand how you write, what you care about, what you ignore, and how your day flows. Gaia removes this mental load. One assistant that understands your entire digital life, remembers everything, and proactively handles boring repetitive work. The real problem is time, energy, and cognitive overload. Open one dashboard, understand your day instantly. Everything else should just happen.

Features

• Truly Proactive AI: Acts before you ask — deadlines, emails, tasks handled
• Automated Workflows: Eliminate repetitive work with multi-step automation
• Smart Todo Management: Todos that research, draft, and execute themselves
• Unified Productivity Hub: Tasks, email, calendar, and goals — one view
• Graph-Based Memory: Everything connected — tasks, projects, meetings, documents
• Integration Marketplace: Hundreds of integrations with Gmail, Slack, Notion, and more
• Multi-Platform: Web, Desktop (macOS, Windows, Linux), and Mobile
• Message from anywhere: Access GAIA on Discord, Slack, and Telegram
• Open Source & Self-Hostable: Full transparency, runs on your own infrastructure

Getting Started

Cloud (zero setup)

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

Self-host or Develop

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 init

gaia 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

Chat with GAIA on Your Favorite Platforms

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	Install the Slack app in your workspace and use /gaia and other slash commands
	Telegram	Message @heygaia_bot and send messages or use /gaia commands

See the Bot Integrations Guide for setup and usage details.

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
└── 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

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.

We rely heavily on open-source software and world-class developer tools. This page exists to credit the projects that make building GAIA possible and to support the open-source culture that drives real progress.

→ https://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

---

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