Meowbert

A self-hosted AI agent workspace for real work. Give an agent a task and it works in its own sandbox on your server: it runs commands, writes code, browses, builds documents, and keeps going while you're away. Use any model that speaks the OpenAI Responses API.

Quickstart · Documentation · What you can count on · Known limitations

Why Meowbert

• Yours, end to end. The web app, API, database, and every agent sandbox run on your own hardware. No telemetry, no hosted service in the middle.
• Any model. Connect OpenAI, a gateway, or a local model server. Offer several models, set reasoning effort per model, and combine them in an Agent Swarm.
• A real computer for the agent. Each task gets a fresh container with a shell, git, Python, Node, a browser, and Office and PDF tools. It's locked down by default, with optional gVisor isolation.
• Work that lasts. Projects keep their files, memory, and task history. Come back to any task weeks later and pick up where you left off, or branch it to try something else.
• Runs while you're away. Schedule tasks, let them loop for hours, and get results in Telegram, Discord, email, or a push notification. A Project Master keeps track of what's running and follows up.
• Made for teams. Multiple users and workspaces, shared projects, per-user limits, and an admin panel.

Features

Quickstart

You need a Linux server (x86-64) with Docker, and an API key for a model provider that supports the OpenAI Responses API. See the system requirements.

git clone https://github.com/XInTheDark/meowbert-ai-agent.git
cd meowbert-ai-agent
./scripts/setup.sh
docker compose up -d

Open http://localhost:5173 and create your account. The first account becomes the admin, and a short wizard walks you through connecting a model provider and choosing models. The Quickstart guide covers each step, and Configuration explains how to reach Meowbert from other machines.

How it works

Web app / desktop app / Telegram, Discord, email
                    │
                    ▼
      API (Fastify) ── PostgreSQL, Redis, Meilisearch
                    │  queues task runs
                    ▼
      Worker ── model provider (OpenAI Responses API)
                    │  runs tools
                    ▼
      Sandbox container per task (Docker, optional gVisor)

The API handles accounts, workspaces, projects, and tasks. The worker runs the agent loop: it calls the model, executes tool calls inside the task's sandbox, and streams events back to the app. Everything is stored in PostgreSQL and on disk, so work survives restarts.

Documentation

The full docs are in apps/docs, and Docker Compose also serves them at http://localhost:4173.

• Using Meowbert: Overview, Task Composer, Scheduled tasks, Workflows & Agent Swarm, Connectors
• Self-hosting: Configuration, Models & Providers, Sandbox & Security, Custom Skills, Backups & Upgrades

About the project

Meowbert started in February 2026 as a personal project and was developed privately for about seven months before this first public release. The history before release isn't included in this repository.

It's early, and some parts are rougher than others. The known limitations list what to expect. Issues and pull requests are welcome; see CONTRIBUTING.md, and report security issues privately.

License

Meowbert is licensed under the GNU Affero General Public License v3.0. Bundled third-party components keep their own licenses; see THIRD_PARTY_NOTICES.md.