FreeTodo is an AI-powered personal task manager with a frontend-backend architecture (Next.js + FastAPI), supporting hierarchical tasks, calendar views, and AI-assisted task breakdown. It provides scripts and environment guidance in README for local setup and development.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
FreeTodo is an AI-powered intelligent todo management application that helps you efficiently manage tasks, boost productivity, and achieve your goals. It supports AI-assisted task breakdown, context-aware suggestions, hierarchical tasks, calendar views, and a desktop Electron option. It follows a frontend-backend separation architecture with FastAPI for backend and Next.js for frontend, using SQLite + ChromaDB for data storage.
How it works
The backend is implemented with FastAPI (Python) and serves endpoints for chat, todo, and task management under lifetrace. The frontend is a Next.js (React + TypeScript) application located in free-todo-frontend. Data is stored in SQLite with a vector database in vector_db. The system includes configuration templates (config.yaml, default_config.yaml, prompt.yaml) and supports prompt customization.
Getting started
Install dependencies and sync environment using uv:
# Install uv for dependency management
# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
Then:
uv sync
# Activate virtual environment
# macOS/Linux
source .venv/bin/activate
# Windows
.venv\Scripts\activate
To start the backend service:
python -m lifetrace.server
The backend port starts from 8001 (or 8100 in build) and the doc URL is shown in console. To start the frontend service:
cd free-todo-frontend
pnpm install
pnpm dev
The frontend port starts from 3001 and proxies to the backend port detected via /health.
Recent releases
- plugin/media-crawler/v1.0.0 Crawler Plugin (2026-02-08): 该插件的功能是爬取 7 大平台、AI 总结
- 0.1.2 0.1.2 (Capybara) (2026-02-06): Doc update by @Royce17; asset update for WeChat visual consistency
- 0.1.1 0.1.1 (Capybara) (2026-01-12): Logo update & OnBoardingTour by @Royce17
- 0.1.0 0.1.0 (Capybara) (2026-01-11): Our first release
Full Changelog: https://github.com/FreeU-group/FreeTodo/compare/0.1.0...0.1.1
Traction
Stars: 2402; Forks: 169; Open issues: 29
Behind the repo
FreeTodo is part of the FreeU groupLifeTrace project; frontend resides in free-todo-frontend and backend in lifetrace. It is licensed under the FreeU Community License and uses Python 3.12 as indicated by the README badge.
Caveats
License: FreeU Community License; Language: TypeScript for frontend; Python 3.12 required for backend; macOS dmg noted in README warnings. The repository provides installation scripts and guidance but no explicit license listing beyond the shield badge.