A modern, multi-tenant platform for building and managing AI Agents.
Platypus is an open-source, full-stack application designed to help you build AI agents. Built with a focus on extensibility and modern web standards, Platypus allows you to create agents that can reason, use tools, and interact with the world.
🌐 Visit the website at platypus.chat.
📚 Full documentation lives at docs.platypus.chat.
- 🏢 Multi-Tenancy: Built-in support for Organizations and Workspaces to isolate data and manage teams.
- 🤖 Agentic Workflows: Create sophisticated agents with custom system prompts, model configurations, and tool assignments.
- ✨ Skills: Create reusable instruction sets that agents can dynamically load on-demand to handle specialized tasks.
- 🧩 Sub-Agents: Agents can delegate specialized tasks to other agents, enabling hierarchical multi-agent workflows with isolated contexts and result streaming.
- 📱 Responsive Design: A fully responsive interface that works seamlessly across desktop, tablet, and mobile devices.
- 🔌 MCP Support: First-class support for the Model Context Protocol (MCP), allowing agents to securely connect to local and remote data sources.
- 📐 Blueprints (experimental): Define a named, organization-scoped set of shared resources (Agents, Skills, MCPs, Providers) and apply it to a Workspace to attach them all in one step. Applying is additive and idempotent, and it's a snapshot — editing a Blueprint never disturbs Workspaces you've already provisioned from it.
- 🏖️ Sandbox (experimental): Give agents shell and filesystem access inside an isolated, per-workspace execution environment. Ships with a Docker reference backend (single-node / self-hosted only — see
compose.sandbox.yaml); the adapter interface is pluggable so other backends can be contributed. - 🧠 Memory: Platypus automatically extracts facts and preferences from your conversations in the background and injects them into future chats, so agents remember things about you over time.
- 📋 Kanban Boards: Organize work visually with drag-and-drop Kanban boards. Agents can create, move, and update cards autonomously via built-in Kanban tools.
- 📊 Dashboards (experimental): Build widget-based dashboards to surface agent data at a glance. Supports metric, text/markdown, image, weather, line chart, bar chart, and pie chart widgets with a drag-and-drop layout editor. Agents can update widget data autonomously via built-in dashboard tools.
- 🔔 Webhooks: Receive real-time HTTP callbacks for notification events, with per-event filtering, custom headers, HMAC-SHA256 signing, and automatic retries.
- ⏰ Schedules: Schedule agents to run automatically at specified times using cron expressions, with support for timezones and one-off executions.
- ⚡ Modern Tech Stack: Built on the bleeding edge with Next.js, Hono.js, Drizzle ORM, pgvector, and Tailwind CSS.
- 🌐 Provider Agnostic: Powered by the Vercel AI SDK, supporting OpenAI, Anthropic, Google, Amazon Bedrock, and OpenRouter.
- ⚖️ MIT Licensed: Open source and free to use.
git clone https://github.com/willdady/platypus.git
cd platypus
cp .env.example .env # set BETTER_AUTH_SECRET and your admin credentials
docker compose up -d # then open http://localhost:3000Caution
Change the default password after your first login!
For configuration, providers, sandbox infrastructure, and production deployment, see the Self-Hosting guide.
The docs site is the single source of truth for setup, concepts, and reference material:
- Getting Started — quick start, first run, and the default admin account.
- Self-Hosting — Docker Compose, configuration & environment, providers & auth, and sandbox infrastructure.
- Concepts — the domain model: Organizations, Workspaces, Agents, Skills, MCP, Sandbox, and Memory.
- Building with Platypus — agents & sub-agents, skills, MCP servers, schedules, boards, and dashboards.
- Reference — backend and frontend configuration reference.
Docs track the latest release; older versions are available by checking out the matching git tag.
Platypus is a monorepo managed by Turborepo:
apps/frontend: A responsive web interface built with Next.js, ShadCN, and Tailwind. It uses the AI SDK for real-time streaming responses.apps/backend: A high-performance REST API built with Hono.js running on Node.js. It handles agent logic, tool execution, and database interactions.packages/schemas: Shared Zod schemas used by both frontend and backend for end-to-end type safety.
The Extending guide covers contribution-facing extension points (sandbox backends, tool sets).
Curious where Platypus is headed — and where it isn't? See ROADMAP.md for the project vision and the themes we're working towards. If you're planning a substantial contribution, read it (especially the non-goals) and open a discussion first so the effort lands well.
Contributions are welcome! Please read our Contributing Guide for details on local development, branch naming, commit conventions, and how to submit a pull request.
Platypus logo by Thiings.co