GAIA is the proactive personal AI assistant that triages your email, plans your calendar, and runs your workflows, right inside WhatsApp and Telegram.
ProductivityGitHub @theexperiencecompanyOnlineOwner unconfirmed
Have you tried it? One tap is enough. No sign-in needed.
Repository information has not been collected yet.
No updates detected yet. GitHub releases will appear here.
GitHub star growth between the latest completed 8-hour observations
DeepSeek Harness Remote can securely connect a phone or another computer to the computer where you run DeepSeek Harness, so you can continue your work anytime and anywhere, check progress anytime, and continue working.
AI translation
Ayakaleaf Pro is a free, open-source, self-hosted Overleaf alternative: Overleaf Community Edition with almost all Server Pro features — track changes, project history, admin panel, SSO, Git-bridge, Z
Open-source, local-first task manager that works offline, syncs every device, runs on a Raspberry Pi, and requires no subscription.
AI translation
Open Source Office suite for users used to MS Office - multi-platform, tuned for performance
Your proactive personal AI assistant for daily life
Taken from the repository README
Loading the full README.
Read the full README ↗The open-source AI assistant that handles your whole day.
GAIA is a personal AI assistant that can automate your whole day. Connect Gmail and it triages your inbox every morning, drafts your replies and turns emails into todos. Connect your calendar and it briefs you before every meeting.
You set none of that up. It's running the moment you connect.
And when something needs you, it comes to you — on iMessage, WhatsApp, Telegram, Slack or Discord.
curl -fsSL https://heygaia.io/install.sh | sh
Gmail, Calendar, Slack, Notion, Linear — different tools, same problem: your day fills with work that isn't your job. Triaging mail, prepping for meetings, chasing updates, copying tasks between apps. Each one costs two minutes. Together they cost your afternoon.
GAIA does that layer for you. It does the work, then tells you when it's done.
| If you want to… | Go here |
|---|---|
| Just use it | heygaia.io — sign up, nothing to install |
| Text it from your phone | iMessage · WhatsApp · Telegram · Slack · Discord |
| Run it on your own machines | curl -fsSL https://heygaia.io/install.sh | sh — or the guide |
| Contribute | Development Setup |
| See how it's built | ARCHITECTURE.md |
Go to heygaia.io. Nothing to install, always up to date.
This is how most people should use GAIA — you skip standing up Postgres, Mongo, Redis, ChromaDB and RabbitMQ yourself.
Your own server, your own keys and models, your data on your disks.
[!IMPORTANT] The licence is noncommercial. Personal and non-profit self-hosting is free; running GAIA inside a business needs an enterprise licence.
You need: a Linux server or Mac with about 8 GB of RAM, and one AI key (OpenAI, OpenRouter, Gemini, or a local Ollama).
1. Install and start
curl -fsSL https://heygaia.io/install.sh | sh
It installs the GAIA CLI, then asks to set GAIA up. Say yes: it installs Docker if it's missing, downloads GAIA and starts it on one port.
2. Open the address it prints (http://gaia.local on your network, or http://localhost:3000), create your admin account and paste your AI key. That's the whole setup.
3. Keep it running
gaia status # is everything healthy?
gaia doctor # what's broken, and how to fix it
gaia update # upgrade to the latest release
gaia backup # save your data
Want HTTPS on your own domain? gaia up --domain gaia.example.com. Every option is in the walkthrough.
Prefer a hosting platform?
Render then needs a few internal addresses filled in, which the Render guide walks through. Coolify (paste one Compose file) and Railway (set up by hand) are in the deploy options, with what each costs and how far each is tested. A plain 8 GB Linux server is the cheapest and the path we test; your ongoing cost there is model API usage plus the server.
Contributing? See Development Setup for hot-reload local dev.
A few things switch on by themselves the moment you connect a tool:
| What | Turns on with | What it does |
|---|---|---|
| Inbox desk | Gmail | Every morning at 8, triages new mail, follows up every thread waiting on you or on someone else, saves reply drafts (never sends), and hands you one briefing |
| Meeting Briefing | Calendar | Researches who you're meeting and what it's about, before you walk in |
| Meeting Reminder | Calendar | A heads-up 10 minutes out, join link included |
You'll never open a settings screen for those. Build your own from the Workflows page:
Workflows run on their own. This is what you ask it directly.
.pptx.$1 a day to never do busywork again.
| Plan | Cost | What you get |
|---|---|---|
| Pro | $30/month | Everything GAIA does: chat on iMessage, WhatsApp, Telegram, Slack and Discord, inbox triage and drafted replies every morning, meeting briefs and reminders, todos it works on, workflows that run without you, long-running jobs, memory, priority support |
| Enterprise | Talk to us | Everything in Pro, plus SSO, SCIM and audit logs, custom integrations, self-host or private cloud, private Slack support, a dedicated engineer and an SLA |
| Platform | How | |
|---|---|---|
| iMessage | Register your number, text /auth, then just type. Pro plan. | |
| Message GAIA | ||
| Telegram | @heygaia_bot — DMs, or @mention it in groups | |
| Slack | Add to your workspace | |
| Discord | Add the bot or join the server |
gaia bridge links your laptop over one outgoing connection — nothing to forward, no ports to open.gaia bridge login # approve the pairing in your browser
gaia bridge fs ~/projects # share a folder
gaia bridge up # connect
GAIA touches your email, your calendar and your files, so we take reports seriously.
Found a vulnerability? Email [email protected] — please don't open a public issue. Our full policy is in SECURITY.md.
Your actual content is never copied into GAIA's database. Email bodies, calendar events and documents are fetched when a request needs them, used, and not kept. GAIA only touches threads relevant to what you asked for, within the scopes you granted on the provider's consent screen.
What is stored is under your control:
/integrations.Self-hosted: yes. Add, replace or remove providers any time in Settings → Providers & Tools (or via environment variables), so you can swap freely.
Cloud: no — models are managed for you and usage follows your plan. You can still pick between the available models in the composer.
Add it as an MCP server from /integrations. Paste the server URL, connect it privately, and its tools are available right away. You can publish it to the community marketplace if you want to share it.
For tools running on your own machine, use gaia bridge instead.
The code is free under PolyForm Noncommercial, so you pay for model API usage, any paid integrations you opt into, and hosting. See Self-host above for sizing.
docs.heygaia.io — Quick Start · Bots · Self-Hosting · Developers
Full-stack Nx monorepo.
apps
├── web Next.js web app heygaia.io
├── desktop Electron desktop app (beta)
├── mobile React Native mobile app (beta)
├── api FastAPI + LangGraph backend
├── voice-agent LiveKit voice worker
└── bots imessage · whatsapp · telegram · slack · discord
packages
└── cli @heygaia/cli — the gaia command
libs
├── shared/py gaia-shared
├── shared/ts shared TypeScript + the unified bot framework
└── wake-word @gaia/wake-word — on-device "Hey GAIA"
docs docs.heygaia.io
infra/docker Docker Compose (development services + self-host)
GAIA runs three tiers of agents. The one you talk to never does the work itself — it hands off, so the conversation stays responsive while long jobs run in the background.
Comms agent Talks to you and narrates progress. Deliberately
│ cannot do work — it can only delegate.
▼ call_executor(task) → returns instantly, runs in background
Executor agent The worker. Shell, files, research, planning, todos,
│ and the handoff tool.
▼ handoff(subagent, task)
Subagents One specialist per integration, dispatched in parallel,
each scoped to only its own tools.
Why bother: a single agent holding 30 integrations' worth of tools picks the wrong one and gets slower with every tool you add. Scoping each integration to its own agent keeps tool choice accurate, and running them in parallel keeps it fast.
Every service and file path is mapped in ARCHITECTURE.md.
Bug fixes, features, docs, tests — all welcome.
🤖 AI and vibe-coded PRs are welcome. Built it with Claude, Cursor, or anything else? Great — just say so in the PR description.
Start with Set up GAIA for development: it takes you from a fresh clone to a running GAIA, your first change and your first pull request.
Developer docs · Open a pull request · Code Style · Commit Messages
Found a bug? Open an issue.
We build in the open. View the roadmap · Request a feature
PolyForm Noncommercial License 1.0.0 — see LICENSE.md.
[!WARNING] This license allows noncommercial use only.
GAIA is built on the shoulders of giants. Full credits at heygaia.io/thanks.
If GAIA saves you an hour this week, a ⭐ helps someone else find it.
Made with ❤️ by The Experience Company