A personal workspace for your notes, plans, and ideas.
Capture searchable notes, organize your knowledge, and plan your days in one place.
Try the live demo · Use Perga Cloud · Self-host Perga
- Write rich-text notes and organize them into folders.
- Search, import, and export your notes.
- Plan today while keeping weekly and monthly context in view.
- Create monthly and custom agendas for longer-term plans.
- Install Perga as a PWA and use it in light or dark mode.
Perga is split into a browser client and an API. A self-hosted installation runs both applications with PostgreSQL.
| Repository | Role | Stack |
|---|---|---|
perga-web |
Responsive browser client and PWA | React, TypeScript, Vite, Tailwind CSS, Tiptap |
perga-api |
REST API, authentication, and data storage | FastAPI, SQLAlchemy, PostgreSQL, Alembic |
perga-docs |
Installation and product documentation | Docusaurus |
- Want to explore first? The public demo opens instantly and does not require sign-up. Its data is shared and reset regularly.
- Want the simplest setup? Perga Cloud is hosted, maintained, and kept up to date for you.
- Want full control? Follow the self-hosting guide to deploy Perga with Docker Compose.
- Want to understand the components? Read the
perga-webandperga-apidocumentation.
The Perga API and web client are available under the MIT License.

