{"id":34888303,"url":"https://github.com/willdady/platypus","last_synced_at":"2026-06-13T06:01:42.434Z","repository":{"id":329678588,"uuid":"1002324568","full_name":"willdady/platypus","owner":"willdady","description":"A modern, multi-tenant platform for building and managing AI Agents","archived":false,"fork":false,"pushed_at":"2026-06-08T02:38:00.000Z","size":7580,"stargazers_count":24,"open_issues_count":4,"forks_count":6,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-06-08T03:13:37.528Z","etag":null,"topics":["ai","ai-agents","ai-assistant","dashboard","kanban","llm","llm-ui","mcp","self-hosted","ui","webui"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/willdady.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-06-15T08:08:10.000Z","updated_at":"2026-06-08T02:38:04.000Z","dependencies_parsed_at":"2026-01-21T07:03:18.853Z","dependency_job_id":null,"html_url":"https://github.com/willdady/platypus","commit_stats":null,"previous_names":["willdady/platypus"],"tags_count":136,"template":false,"template_full_name":null,"purl":"pkg:github/willdady/platypus","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/willdady%2Fplatypus","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/willdady%2Fplatypus/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/willdady%2Fplatypus/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/willdady%2Fplatypus/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/willdady","download_url":"https://codeload.github.com/willdady/platypus/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/willdady%2Fplatypus/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34273788,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-13T02:00:06.617Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","ai-agents","ai-assistant","dashboard","kanban","llm","llm-ui","mcp","self-hosted","ui","webui"],"created_at":"2025-12-26T04:20:35.158Z","updated_at":"2026-06-13T06:01:42.011Z","avatar_url":"https://github.com/willdady.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![](assets/platypus_256x256.png)\n\n# Platypus\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue.svg)](https://www.typescriptlang.org/)\n[![Next.js](https://img.shields.io/badge/Next.js-16-black.svg)](https://nextjs.org/)\n[![Hono](https://img.shields.io/badge/Hono-API-orange.svg)](https://hono.dev/)\n[![Docker](https://img.shields.io/badge/Docker-Ready-2496ED.svg)](https://www.docker.com/)\n[![pnpm](https://img.shields.io/badge/pnpm-workspace-F69220.svg)](https://pnpm.io/)\n\n**A modern, multi-tenant platform for building and managing AI Agents.**\n\nPlatypus 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.\n\n📚 **Full documentation lives at [docs.platypus.chat](https://docs.platypus.chat).**\n\n![](assets/00_screenshot.png)\n\n## ✨ Key Features\n\n- **🏢 Multi-Tenancy:** Built-in support for Organizations and Workspaces to isolate data and manage teams.\n- **🤖 Agentic Workflows:** Create sophisticated agents with custom system prompts, model configurations, and tool assignments.\n- **✨ Skills:** Create reusable instruction sets that agents can dynamically load on-demand to handle specialized tasks.\n- **🧩 Sub-Agents:** Agents can delegate specialized tasks to other agents, enabling hierarchical multi-agent workflows with isolated contexts and result streaming.\n- **📱 Responsive Design:** A fully responsive interface that works seamlessly across desktop, tablet, and mobile devices.\n- **🔌 MCP Support:** First-class support for the **Model Context Protocol** (MCP), allowing agents to securely connect to local and remote data sources.\n- **📐 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.\n- **🏖️ 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.\n- **🧠 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.\n- **📋 Kanban Boards:** Organize work visually with drag-and-drop Kanban boards. Agents can create, move, and update cards autonomously via built-in Kanban tools.\n- **📊 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.\n- **🔔 Webhooks:** Receive real-time HTTP callbacks for notification events, with per-event filtering, custom headers, HMAC-SHA256 signing, and automatic retries.\n- **⏰ Schedules:** Schedule agents to run automatically at specified times using cron expressions, with support for timezones and one-off executions.\n- **⚡ Modern Tech Stack:** Built on the bleeding edge with **Next.js**, **Hono.js**, **Drizzle ORM**, **pgvector**, and **Tailwind CSS**.\n- **🌐 Provider Agnostic:** Powered by the Vercel AI SDK, supporting OpenAI, Anthropic, Google, Amazon Bedrock, and OpenRouter.\n- **⚖️ MIT Licensed:** Open source and free to use.\n\n![](assets/01_screenshot.png)\n\n## 🚀 Quick Start (Docker)\n\n```bash\ngit clone https://github.com/willdady/platypus.git\ncd platypus\ncp .env.example .env   # set BETTER_AUTH_SECRET and your admin credentials\ndocker compose up -d   # then open http://localhost:3000\n```\n\n\u003e [!CAUTION]\n\u003e Change the default password after your first login!\n\nFor configuration, providers, sandbox infrastructure, and production deployment, see the [Self-Hosting guide](https://docs.platypus.chat/self-hosting).\n\n## 📚 Documentation\n\nThe docs site is the single source of truth for setup, concepts, and reference material:\n\n- **[Getting Started](https://docs.platypus.chat/getting-started)** — quick start, first run, and the default admin account.\n- **[Self-Hosting](https://docs.platypus.chat/self-hosting)** — Docker Compose, configuration \u0026 environment, providers \u0026 auth, and sandbox infrastructure.\n- **[Concepts](https://docs.platypus.chat/concepts)** — the domain model: Organizations, Workspaces, Agents, Skills, MCP, Sandbox, and Memory.\n- **[Building with Platypus](https://docs.platypus.chat/building-with-platypus)** — agents \u0026 sub-agents, skills, MCP servers, schedules, boards, and dashboards.\n- **[Reference](https://docs.platypus.chat/reference)** — backend and frontend configuration reference.\n\nDocs track the latest release; older versions are available by checking out the matching git tag.\n\n## 🏗️ Architecture\n\nPlatypus is a monorepo managed by [Turborepo](https://turbo.build/):\n\n- **`apps/frontend`**: A responsive web interface built with Next.js, ShadCN, and Tailwind. It uses the AI SDK for real-time streaming responses.\n- **`apps/backend`**: A high-performance REST API built with Hono.js running on Node.js. It handles agent logic, tool execution, and database interactions.\n- **`packages/schemas`**: Shared Zod schemas used by both frontend and backend for end-to-end type safety.\n\nThe [Extending guide](https://docs.platypus.chat/extending) covers contribution-facing extension points (sandbox backends, tool sets).\n\n## 🗺️ Roadmap\n\nCurious where Platypus is headed — and where it isn't? See [ROADMAP.md](ROADMAP.md) for\nthe project vision and the themes we're working towards. If you're planning a substantial\ncontribution, read it (especially the non-goals) and open a discussion first so the effort\nlands well.\n\n## 🤝 Contributing\n\nContributions are welcome! Please read our [Contributing Guide](CONTRIBUTING.md) for details on local development, branch naming, commit conventions, and how to submit a pull request.\n\n---\n\nPlatypus logo by [Thiings.co](https://www.thiings.co/things)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwilldady%2Fplatypus","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwilldady%2Fplatypus","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwilldady%2Fplatypus/lists"}