CarpeDiem
CarpeDiem (carpe diem — seize the day) turns quick notes into a realistic day plan: natural-language capture, a smart morning proposal, pomodoro focus during the day, evening closing. Offline-first, in English or Italian, no account.
Capture in seconds (n, natural language) → morning briefing with proposal to confirm (P)
→ work from the Day plan with pomodoro (o) → evening Closing (R).
In the app, open the menu (m) → Day → Recommended workflow for the 5-step daily checklist.
Install in 2 minutes
- You need Python 3.12+: check with
python3 --version. - Recommended: isolated install with pipx (puts
carpediemon your PATH):
pipx install carpediem
From the git repo:
pipx install git+https://github.com/fabx-dev/carpediem.git
- Alternative for developers (virtualenv):
python3 -m venv .venv
.venv/bin/pip install .
- Start the TUI:
carpediem
On first run: load the demo data to explore, or start empty.
Check it works:
carpediem --help
carpediem list
Common issues: pipx: command not found (install pipx first), old Python (<3.12), separate data dir with TASKO_HOME=/tmp/carpediem-demo carpediem. Docker (docker compose up) is dev-only, not the main install path.
Requires Python 3.12+. Built with Textual; data stays in local JSON (see Data below).
Keys
| Key | Action |
|---|---|
n / s |
New todo / subtask of selected |
Space then 1/2/3 |
Active / Paused / Done |
Enter / e |
Details (with inline edit) / Edit |
d / u |
Delete (confirm) / Undo |
o / O / X |
Start-open pomodoro / pause-resume / complete-skip |
b / B |
Mini-kanban / full board |
c / w / p / k |
Calendar / week / daily plan / stats |
f / t / g / / |
State, tag, project, search filters |
T / v / m / h |
Templates / theme / menu / help |
q |
Quit |
Press m for the menu (settings, goals, backup, import/export, archive). Press Tasti there for the full key list.
Data
Everything lives in local JSON next to your home (offline-first):
| File | Content |
|---|---|
~/.todo_app.json |
Tasks (+ .bak.json previous copy) |
~/.todo_templates.json |
Templates |
~/.todo_pomodoro.json |
Timer session + cycle |
~/.todo_config.json |
Theme, filters, goals, language |
~/.todo_archive.json |
Archived done tasks |
~/Tasko_backups/ |
Automatic zip snapshots (14 kept) |
~/CarpeDiem_screenshots/ |
SVG screenshots, CSV/Markdown exports |
Restore a backup any time from the menu (Backup: ripristina). Language follows the system (Italian or English), override with TASKO_LANG=it|en or in Settings.
Dev
pip install -r requirements-dev.txt
python -m pytest tests/ -q
python -m ruff check src/ tests/
See CONTRIBUTING.md. Hobby project, Italian-first: issues in Italian or English welcome.
License
MIT — see LICENSE and CHANGELOG.md.
1 maintainer
Release files for carpediem 0.12.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| carpediem-0.12.0.tar.gz | 196.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| carpediem-0.12.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 342.4 kB
Release files / carpediem-0.12.0.tar.gz
| Download URL | carpediem-0.12.0.tar.gz |
|---|---|
| Size | 196.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3bb9ca4b106c3500c0a75fd0607638991d554952f2b01780e4b2f736f816be3a
|
|
BLAKE2b-256 checksum How to use checksums |
af93355c86ffd07198c7bac9cea45f8c467382df519f5b9da957ef988239ec90
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 21, 2026.
Transparency logRelease files / carpediem-0.12.0-py3-none-any.whl
| Download URL | carpediem-0.12.0-py3-none-any.whl |
|---|---|
| Size | 145.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c7891129269e73d2b11b8c3288689ccdc731e824013d68b2e2812fec39cd17e6
|
|
BLAKE2b-256 checksum How to use checksums |
1ecc3430c16593db07152e773a393260cb30cdd2abd1320bcc3cd73ff85590e2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 21, 2026.
Transparency log
