             .__         .__        
___________  |  | _____  |__|____   
\____ \__  \ |  | \__  \ |  \__  \  
|  |_> > __ \|  |__/ __ \|  |/ __ \_
|   __(____  /____(____  /__(____  /
|__|       \/          \/        \/

# Your AI tools finally share one memory. [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) [![Release](https://img.shields.io/github/v/release/byte5ai/palaia?include_prereleases&label=release)](https://github.com/byte5ai/palaia/releases) [![v3 CI](https://github.com/byte5ai/palaia/actions/workflows/v3-ci-batch.yml/badge.svg?branch=main)](https://github.com/byte5ai/palaia/actions/workflows/v3-ci-batch.yml) [![Container image](https://img.shields.io/badge/image-ghcr.io%2Fbyte5ai%2Fpalaia--hub-blue?logo=docker&logoColor=white)](v3/deploy/README.md) [Get started](#get-started-in-60-seconds) · [What it does](#what-it-does-for-you) · [Docs](v3/site/docs/src/content/docs/index.md) · [How it works](v3/docs/how-it-works.md) · [Coming from v2?](v3/docs/migrate-from-v2.md)

palaia is a hub you run yourself: on a server in your office, in your own cloud account, or on a machine at home. Every AI tool you use connects to it once: Claude, ChatGPT, Codex, Gemini, and any other tool that speaks MCP, the open standard AI tools use to reach outside data and tools. From then on they share one memory and one set of tools, and they can hand work to each other. Your data stays in plain files on hardware you control. Think Home Assistant, for your AI tools.

Claude, Claude Code, ChatGPT, Codex, Gemini and any other MCP client connect to one palaia hub, which gives them one memory, shared tools and a way for agents to reach each other, stored as plain Markdown files on your own hardware.

> [!NOTE] > **palaia v3 is a release candidate (`3.0.0-rc8`).** Everything below works and is > tested. Try it, keep backups, and [tell us what breaks](https://github.com/byte5ai/palaia/issues). > palaia v2 is [retired](#already-using-palaia-v2) and gets critical fixes only. ## What it does for you - **Your AI tools remember, together.** Tell one assistant about a decision and the others know it too. Your memory is a folder of plain Markdown notes you can open in any editor (Obsidian opens it as-is), search, and back up like any other files. - **Set up a tool once, use it everywhere.** Install an add-on in palaia and every connected AI can use it. No more pasting the same configuration into five apps. - **Your agents can work as a team.** An AI session on your laptop can hand a task to one on your server, with the context attached, and find out who is already working on what. - **Runs where you decide.** A server in your office, a machine in your cloud account, a NAS, or a Raspberry Pi. No account with us, no subscription, no data leaving your infrastructure unless you say so. - **Safe by default.** Your dashboard stays on your private network. ChatGPT and Claude reach only palaia's AI connection, over HTTPS, and sign in with your account. Back everything up with one click. ## Get started in 60 seconds You need [Docker](https://docs.docker.com/get-started/get-docker/). That is the whole prerequisite list. ```bash docker run -d --name palaia \ --network host -e PALAIA_CLOUD_BIND=127.0.0.1 \ -v palaia_home:/data \ --restart unless-stopped \ --security-opt no-new-privileges:true --cap-drop ALL \ --read-only --tmpfs /tmp --tmpfs /run \ ghcr.io/byte5ai/palaia:beta ``` Then open **`http://palaia.local:8420`** in a browser on any device on the same network (or `http://:8420` if your network blocks the name). That is the command for a Linux machine; with Docker Desktop on a Mac or Windows PC, replace the `--network host …` line with `-p 8420:8420` and open `http://localhost:8420`. palaia's setup opens by itself and takes it from there: your first memory, your account, cloud access if you want it, your first AI app. No config files, no second command. Once `3.0.0` is final, use `:stable` instead of `:beta`. Updating later is one click in the dashboard. **Other ways to install** | You have… | Do this | |---|---| | A Synology NAS | Paste one file into Container Manager, no terminal: [step-by-step guide](v3/site/docs/src/content/docs/install-synology.md) | | A Raspberry Pi | The command above works on 64-bit Raspberry Pi OS with Docker. A ready-to-flash card image is [in progress](v3/deploy/pi-image/) | | A rented server (Hetzner, DigitalOcean, AWS, …) | Paste [`cloud-init.yaml`](v3/deploy/cloud-init.yaml) into your provider's user-data field. It installs everything and keeps the hub off the open internet | | Umbrel, CasaOS, Runtipi, TrueNAS SCALE | [Packages are ready](v3/deploy/stores/); until they are in the official catalogs, use the command above | | Docker Compose or Portainer | [`docker-compose.yml`](v3/deploy/docker-compose.yml) | > **Release candidate:** the files and packages in this table pin `ghcr.io/byte5ai/palaia:stable`, > which does not exist until `3.0.0` is final. Until then, change `:stable` to `:beta` in whatever you use. Stuck? See [Your first shared memory](v3/site/docs/src/content/docs/first-shared-memory.md) for a walkthrough with screenshots, or [troubleshooting](v3/site/docs/src/content/docs/troubleshooting.md). ## Works with Claude Code · Claude Desktop · claude.ai · ChatGPT · Codex · Gemini CLI · Grok · LM Studio · any other MCP-compatible tool Each one has a short [connect guide](v3/site/docs/src/content/docs/connect/clients/). Claude Desktop gets a one-click bundle: download, click, connected. Everything is managed from a dashboard in your browser:

Overview	Memories
AI apps	Add-ons

## Learn more - **[Documentation](v3/site/docs/src/content/docs/index.md):** getting started, connecting each tool, backup and restore, troubleshooting. - **[How it works](v3/docs/how-it-works.md):** the full feature list, the architecture, the test evidence behind the claims, and when palaia is not the right fit. - **[Security](v3/SECURITY.md)** and the [threat model](v3/docs/security/threat-model.md). - **[What is left before 3.0.0](v3/RELEASING.md)** and [what shipped](v3/CHANGELOG.md). - **For contributors:** [`CONTRIBUTING.md`](CONTRIBUTING.md) and [`v3/README.md`](v3/README.md) for the dev setup. ## Already using palaia v2? palaia v2 is the Python package at the root of this repository. It is retired: it gets no new features, v3 replaces it, and only a critical fix (security, data loss, a broken release) can still land. It stays installable, and its [documentation](docs/getting-started.md) is unchanged. When you are ready, one command imports your v2 knowledge into v3, and the [migration guide](v3/docs/migrate-from-v2.md) covers what changes and how to roll back. ## Community & support - **Questions, bugs, ideas:** [open an issue](https://github.com/byte5ai/palaia/issues). - **Security vulnerabilities:** please do not open a public issue. Use GitHub's [private vulnerability reporting](https://github.com/byte5ai/palaia/security/advisories/new) instead. Details in [`v3/SECURITY.md`](v3/SECURITY.md). ## License [MIT](LICENSE) · © 2026 [byte5 GmbH](https://byte5.de)