Perga
an open-source daily planner with notes
Last verified:
What is Perga?
Perga is an open-source personal organizer that helps you plan and organize your days and months efficiently. It combines a daily planner with simple notes into one unified tool, allowing users to stay focused and make progress without keeping everything in their head. The system consists of two main components: Perga API (a FastAPI-based backend providing core functionality and data storage) and Perga Web (a standalone React-based browser client that provides a responsive, accessible interface).
Key features include a daily planner for organizing tasks and activities, monthly and custom agendas for planning ahead and tracking goals, user authentication with JWT tokens for secure access to personal data, and a responsive design with dark theme that works on both desktop and mobile devices. The tool also offers a RESTful API for developers who want to integrate or extend functionality.
Perga is designed for individuals who want a simpler way to organize their life - whether for study, work, side projects, or life in general. It is particularly suitable for developers and tech-savvy users who appreciate open-source software and want the option to self-host. The demo version at demo.getperga.me allows users to try Perga without any installation.
The project is fully open source under the MIT License, created by Dima, a full-stack developer who uses it daily. Users can either use Perga Cloud for a no-setup experience or host it themselves for full control over their data.
Perga pricing
Pricing model: Freemium
Perga is fully open source and free under the MIT License. You can self-host it yourself with no cost using the GitHub repositories (perga-api and perga-web). A free hosted demo is available at demo.getperga.me where you can try Perga without installation. Perga Cloud offers a no-setup hosted experience (pricing details not publicly specified on the documentation). The self-hosted option gives you full control over your data at no cost, requiring only your own infrastructure (PostgreSQL 15+ and Node.js 20+).
Perga pros
- Fully open source under MIT License
- Daily planner for task organization
- Monthly and custom agendas for long-term planning
- Simple notes integrated with planner
- User authentication with JWT tokens
- Responsive design works on desktop and mobile
- Dark theme available
- No installation required with hosted demo
- Self-hosting option for full data control
- RESTful API for integrations
- Interactive API documentation with Swagger UI
- Built with modern tech stack (React 19, TypeScript, FastAPI)
- Docker Compose support for easy deployment
- Monthly agenda item counts display
- Copy and snooze features for day items
- Reorder functionality for tasks and agendas
- Archive/unarchive capability for agendas
Perga cons
- Notes feature not yet implemented (on roadmap)
- Projects feature not yet implemented (on roadmap)
- Inbox feature not yet implemented (on roadmap)
- Keyboard shortcuts not yet implemented (on roadmap)
- No dedicated mobile app yet (on roadmap)
- Requires self-setup for self-hosted version
- PostgreSQL 15+ required for backend
- Node.js 20+ required for web client
- Signup can be disabled hiding registration option
- CORS configuration needed for custom deployments
Frequently asked questions about Perga
What is Perga?
Perga is an open-source personal organizer that helps you plan and organize your days and months efficiently. It merges a daily planner and simple notes into one place, created by full-stack developer Dima who uses it daily for study, work, side projects, and life in general.
Is Perga free to use?
Yes, Perga is fully open source under the MIT License and always will be. You can self-host it yourself at no cost, or try the free hosted demo at demo.getperga.me without any installation required.
How do I try Perga without installing it?
You can try Perga without installation by visiting the demo version at https://demo.getperga.me/. This hosted demo gives you full access to test the daily planner, monthly agendas, and other features.
Can I self-host Perga?
Yes, Perga is designed for self-hosting. You can clone the repositories from GitHub (perga-api for backend and perga-web for frontend), configure your environment, and run it yourself using Docker Compose or manually with Python 3.10+ and Node.js 20+.
What technologies is Perga built with?
Perga API is built with FastAPI, SQLAlchemy, Alembic, and PostgreSQL. Perga Web is a standalone SPA built with React 19, TypeScript (~5.7), Vite 6, Tailwind CSS 4, React Router 7, and Axios.
What features does Perga currently have?
Current features include daily planner for organizing tasks, monthly and custom agendas for planning ahead, user authentication with JWT tokens, responsive design with mobile support, dark theme, RESTful API, and interactive API documentation with Swagger UI/ReDoc.
What features are on the roadmap?
The roadmap includes Notes, Projects, Inbox, Keyboard Shortcuts, and a Mobile App. These features are planned but not yet implemented in the current version.
How do I authenticate in Perga?
Perga uses JWT token-based authentication. You can sign up via POST /api/v1/auth/signup/, get access tokens via POST /api/v1/auth/access_token/, refresh tokens, and access user endpoints for getting and updating user information.
Can I reorder tasks in Perga?
Yes, Perga supports reordering for both day items and agenda items. Use POST /api/v1/planner/days/items/reorder/ for day items and POST /api/v1/planner/agendas/items/reorder/ for agenda items within an agenda.
Where can I find Perga's source code?
Perga's source code is on GitHub. The backend API is at https://github.com/dbtiunov/perga-api and the web client is at https://github.com/dbtiunov/perga-web. Both are licensed under MIT.