[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-73904":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":10,"language":11,"languages":10,"totalLinesOfCode":10,"stars":12,"forks":13,"watchers":14,"openIssues":15,"contributorsCount":16,"subscribersCount":16,"size":16,"stars1d":17,"stars7d":18,"stars30d":19,"stars90d":16,"forks30d":16,"starsTrendScore":14,"compositeScore":20,"rankGlobal":10,"rankLanguage":10,"license":21,"archived":22,"fork":22,"defaultBranch":23,"hasWiki":24,"hasPages":24,"topics":25,"createdAt":10,"pushedAt":10,"updatedAt":30,"readmeContent":31,"aiSummary":32,"trendingCount":16,"starSnapshotCount":16,"syncStatus":33,"lastSyncTime":34,"discoverSource":35},73904,"FreeTodo","FreeU-group\u002FFreeTodo","FreeU-group","Auto-Manage Your Personal Task Context with AI.","",null,"TypeScript",2337,168,54,7,0,18,51,136,108.68,"Other",false,"main",true,[26,27,28,29],"agentic-ai","context-engineering","lifelog","todolist","2026-06-12 04:01:12","![FreeTodo Logo](.github\u002Fassets\u002Ffree_todo_banner.png)\n\n![GitHub stars](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fstars\u002FFreeU-group\u002FFreeTodo?style=social) ![GitHub forks](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fforks\u002FFreeU-group\u002FFreeTodo?style=social) ![GitHub issues](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fissues\u002FFreeU-group\u002FFreeTodo) [![License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-FreeU%20Community-blue.svg)](LICENSE) ![Python version](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fpython-3.12-blue.svg) ![FastAPI](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002FFastAPI-0.100+-green.svg)\n\n**Language**: [English](README.md) | [中文](README_CN.md)\n\n[📖 Documentation](https:\u002F\u002Ffreeyou.club\u002Flifetrace\u002Fintroduction.html) • [🚀 Quick Start](#quick-start) • [💡 Features](#core-features) • [🔧 Development](#development-guide) • [🤝 Contributing](#contributing)\n\n# FreeTodo - Just Do It.\n\n## Project Overview\n\n**FreeTodo** is an AI-powered intelligent todo management application that helps you efficiently manage tasks, boost productivity, and achieve your goals. Through conversational AI interaction and smart task breakdown, FreeTodo transforms complex projects into actionable steps.\n\n## Core Features\n\n### 🤖 AI Smart Assistant\n- **Intelligent Task Breakdown**: AI automatically decomposes complex tasks into manageable subtasks with a guided questionnaire flow\n- **Smart Task Extraction**: Extract actionable todos from AI conversation responses\n- **Context-Aware Suggestions**: AI provides task recommendations based on your current todo context\n\n### ✅ Comprehensive Task Management\n- **Hierarchical Tasks**: Support for parent-child task relationships with unlimited nesting\n- **Priority & Status**: Four priority levels (urgent\u002Fhigh\u002Fmedium\u002Flow) and multiple status states\n- **Tags & Categories**: Organize todos with custom tags for easy filtering\n- **Deadline Management**: Set deadlines with visual reminders\n- **Rich Notes**: Add detailed notes and descriptions to each todo\n\n### 📅 Multi-View Calendar\n- **Day\u002FWeek\u002FMonth Views**: Flexible calendar views to visualize your schedule\n- **Drag & Drop Scheduling**: Easily drag todos to calendar slots to schedule them\n- **Quick Todo Creation**: Create todos directly from calendar time slots\n\n### 🎨 Modern User Interface\n- **Multi-Panel Layout**: Customizable panel arrangement (Todos + Chat + Detail)\n- **Dark\u002FLight Themes**: Beautiful themes with multiple color schemes\n- **Internationalization**: Full support for English and Chinese\n- **Responsive Design**: Optimized for various screen sizes\n\n### 💻 Desktop Application\n- **Electron App**: Native desktop experience on Windows & macOS\n- **System Integration**: Native notifications and system tray support\n\n## System Architecture\n\nFreeTodo adopts a **frontend-backend separation** architecture:\n\n- **Backend**: FastAPI (Python) - Provides RESTful API (located in `lifetrace\u002F` directory)\n- **Frontend**: Next.js (React + TypeScript) - Modern web interface (located in `free-todo-frontend\u002F` directory)\n- **Data Layer**: SQLite + ChromaDB (for AI features)\n\n## Quick Start\n\n### Environment Requirements\n\n**Backend**:\n\n- Python 3.12\n- Supported OS: Windows, macOS, Linux\n- Optional: CUDA support (for GPU acceleration)\n\n**Frontend**:\n\n- Node.js 20+\n- pnpm package manager\n\n\u003C!-- ### One-Click Install & Start\n\n> Requires Python 3.12+, Node.js 20+, and Git. Tauri\u002FElectron build also requires Rust.\n\n**macOS\u002FLinux**\n\n```bash\ncurl -fsSL https:\u002F\u002Fraw.githubusercontent.com\u002FFreeU-group\u002FFreeTodo\u002Fmain\u002Fscripts\u002Finstall.sh | bash\n```\n\n**Windows (PowerShell)**\n\n```powershell\niwr -useb https:\u002F\u002Fraw.githubusercontent.com\u002FFreeU-group\u002FFreeTodo\u002Fmain\u002Fscripts\u002Finstall.ps1 | iex\n```\n\nFor full options, environment variables, and examples, see: [.github\u002FINSTALL.md](.github\u002FINSTALL.md) -->\n\n### Install Dependencies\n\nThis project uses [uv](https:\u002F\u002Fgithub.com\u002Fastral-sh\u002Fuv) for fast and reliable dependency management.\n\n**Install uv:**\n\n```bash\n# macOS\u002FLinux\ncurl -LsSf https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.sh | sh\n\n# Windows\npowershell -c \"irm https:\u002F\u002Fastral.sh\u002Fuv\u002Finstall.ps1 | iex\"\n```\n\n> **Note**: After installation, `uv` may not be immediately available in the current terminal. To activate it in the current session:\n>\n> - **Windows (PowerShell)**: Run `$env:Path = \"$env:USERPROFILE\\.local\\bin;$env:Path\"` to refresh PATH\n> - **macOS\u002FLinux**: Run `exec $SHELL` to reinitialize your shell session, or restart your terminal\n>\n> Alternatively, you can simply open a new terminal window and `uv` will be available automatically.\n\n**Install dependencies and sync environment:**\n\n```bash\n# Sync dependencies from pyproject.toml and uv.lock\nuv sync\n\n# Activate the virtual environment\n# macOS\u002FLinux\nsource .venv\u002Fbin\u002Factivate\n\n# Windows\n.venv\\Scripts\\activate\n```\n\n### Start the Backend Service\n\n> **Note**: On first run, the system will automatically create `config.yaml` from `default_config.yaml` if it doesn't exist. You can customize your settings by editing `lifetrace\u002Fconfig\u002Fconfig.yaml`.\n\n**Start the server:**\n\n```bash\npython -m lifetrace.server\n```\n\n> **Customize Prompts**: If you want to modify AI prompts for different features, you can edit `lifetrace\u002Fconfig\u002Fprompt.yaml`.\n\nThe backend service will automatically find an available port starting from `8001` (or `8100` for build version). If the default port is occupied, it will automatically use the next available port and display the actual port in the console.\n\n- **Default Backend Port**: `http:\u002F\u002Flocalhost:8001`\n- **API Documentation**: The actual API docs URL will be displayed in the console (typically `http:\u002F\u002Flocalhost:8001\u002Fdocs`)\n\n### Start the Frontend Service\n\nThe frontend is required to use FreeTodo. Start the frontend development server:\n\n```bash\ncd free-todo-frontend\n\npnpm install\npnpm dev\n```\n\nThe frontend development server will:\n- Automatically find an available port starting from `3001` (default port for development)\n- Automatically detect the running FreeTodo backend port by checking the `\u002Fhealth` endpoint\n- Set up API proxy to the detected backend port\n\nThe actual frontend URL and backend connection status will be displayed in the console. Once both services are running, open your browser and navigate to the displayed frontend URL (typically `http:\u002F\u002Flocalhost:3001`) to enjoy FreeTodo! 🎉\n\n> **Note**: If ports are occupied, both frontend and backend will automatically find the next available ports. The console will show the actual ports being used.\n\nFor more details, see: [free-todo-frontend\u002FREADME.md](free-todo-frontend\u002FREADME.md)\n\n## 📋 TODO & Roadmap\n\n> 📖 **Full Roadmap**: Check out the detailed [Project Roadmap](.github\u002FROADMAP.md) to learn about the complete vision and development plan of the FreeU project.\n\n### 🎯 FreeU Overall Project Roadmap\n\n#### 1. LifeTrace (v0.2 Completed)\n- ✓ **Computer Activity Flow Construction**: Generate personal activity flows through screenshots\n- 🔮 **Future Plans**: Audio acquisition, video environment, smart device integration, local LLM optimization\n\n#### 2. Free Todo (v0.1 Currently In Progress)\n- 🚧 **Current Focus**: Building the ultimate To-Do List\n- 🎯 **Core Mission**: Fix user intentions, form personal context organization, lay the foundation for proactive services\n\n#### 3. Proactive Service Phase (Future Planning)\n- Provide proactive services based on LifeTrace data and Free Todo intentions\n\n---\n\n### 🚧 Free Todo Recent Plans (Focus on Input Layer)\n\n**Goal**: Collect as much information as possible from users' daily lives and gather it as Todos\n\n- 🎨 **UI Dynamic Island**\n  - ☐ Control voice input and screenshot scheduled task switches\n  - ☐ Provide convenient windows to access Todo list and conversation interface\n\n- 🤖 **Agent Development**\n  - 🚧 Develop AI tool scheduling capability\n  - ☐ Upgrade from basic conversation to intelligent Agent supporting multiple tool calls\n\n---\n\n### 📐 Free Todo Three-Layer Roadmap\n\n#### Input Layer: Reduce Input Burden, Thought-Stream-Like Capture\n- ☐ Voice input (Dynamic Island, hotkey activation)\n- ☐ Multimodal input (text, screenshots, voice)\n- ☑ Social software integration (WeChat, Feishu todo capture)\n- ☑ Intelligent message todo extraction\n\n#### Intermediate Processing Layer: From \"Chaos\" to \"Order\"\n- ☑ AI task breakdown (\"big rocks\" into \"small stones\")\n- ☑ AI intent completion \u002F task detail completion\n- ☐ Automatic classification and organization\n- ☐ Intelligent task priority planning\n- ☑ Todo context construction\n\n#### Output Layer: Psychological Security + Warm, Reliable Secretary Partner\n- ☐ AI secretary personification\n- ☐ Schedule reminders (currently in progress)\n- ☐ Task focus mode (display only partial tasks)\n- ☐ Completed task reinforcement (merit ledger)\n- ☐ Overdue task re-planning\n\n---\n\n### 🔬 Features in Development\n\nFree Todo's panel switch bar contains some panels that are currently under development. These panels showcase our future feature directions for community reference and understanding.\n\n**🤝 Community Participation**: We warmly welcome community members to participate!\n- 🎨 **Panel Contributions**: Contribute your own panel designs or propose improvement suggestions\n- 🤖 **Agent Algorithm Contributions**: Contribute new Agent algorithms, we actively merge them!\n\n---\n\n### ✅ Recently Completed\n\n- ☑ **AI Task Breakdown** - Intelligent task decomposition with questionnaire flow\n- ☑ **Multi-Panel Interface** - Flexible layout with customizable panels\n- ☑ **Calendar Integration** - Day\u002FWeek\u002FMonth views with drag-and-drop\n\n---\n\n> 💡 **Want to contribute?** Check out our [Contributing Guidelines](#contributing) and pick up any TODO item that interests you!\n\n## Development Guide\n\n### Git Hooks (Pre-commit)\n\nThis repo uses a shared `.githooks\u002F` directory. Run the setup script once per clone\u002Fworktree:\n\n```bash\n# macOS\u002FLinux\nbash scripts\u002Fsetup_hooks_here.sh\n\n# Windows (PowerShell)\npowershell -ExecutionPolicy Bypass -File scripts\u002Fsetup_hooks_here.ps1\n```\n\n> **Note**: Do not run `pre-commit install` here. The repo uses `core.hooksPath` and `pre-commit install` will refuse when it is set.\n\nFor details, see: [.github\u002FPRE_COMMIT_GUIDE.md](.github\u002FPRE_COMMIT_GUIDE.md)\n\n### Project Structure\n\n```\n├── .github\u002F                    # GitHub repository assets\n│   ├── assets\u002F                 # Static assets (images for README)\n│   ├── BACKEND_GUIDELINES.md   # Backend development guidelines\n│   ├── FRONTEND_GUIDELINES.md  # Frontend development guidelines\n│   ├── CONTRIBUTING.md         # Contributing guidelines\n│   └── ...                     # Other GitHub repository files\n├── .githooks\u002F                  # Repo-local git hooks (pre-commit, post-checkout)\n├── lifetrace\u002F                  # Backend modules (FastAPI)\n│   ├── server.py               # Web API service entry point\n│   ├── config\u002F                 # Configuration files\n│   │   ├── config.yaml         # Main configuration (auto-generated)\n│   │   ├── default_config.yaml # Default configuration template\n│   │   ├── prompt.yaml         # AI prompt templates\n│   │   └── rapidocr_config.yaml# OCR configuration\n│   ├── routers\u002F                # API route handlers\n│   │   ├── chat.py             # Chat interface endpoints\n│   │   ├── todo.py             # Todo endpoints\n│   │   ├── task.py             # Task management endpoints\n│   │   └── ...                 # Other endpoints\n│   ├── schemas\u002F                # Pydantic data models\n│   ├── services\u002F               # Business logic service layer\n│   ├── repositories\u002F           # Data access layer\n│   ├── storage\u002F                # Data storage layer\n│   ├── llm\u002F                    # LLM and AI services\n│   ├── jobs\u002F                   # Background jobs\n│   ├── util\u002F                   # Utility functions\n│   └── data\u002F                   # Runtime data (generated)\n│       ├── lifetrace.db        # SQLite database\n│       ├── vector_db\u002F          # Vector database storage\n│       └── logs\u002F               # Application logs\n├── free-todo-frontend\u002F         # Frontend application (Next.js) ⭐\n│   ├── app\u002F                    # Next.js app directory\n│   ├── apps\u002F                   # Feature modules\n│   │   ├── todo-list\u002F          # Todo list module\n│   │   ├── todo-detail\u002F        # Todo detail module\n│   │   ├── chat\u002F               # AI chat module\n│   │   ├── calendar\u002F           # Calendar module\n│   │   ├── settings\u002F           # Settings module\n│   │   └── ...                 # Other modules\n│   ├── components\u002F             # React components\n│   ├── lib\u002F                    # Utilities and services\n│   ├── electron\u002F               # Electron desktop app\n│   ├── package.json            # Frontend dependencies\n│   └── README.md               # Frontend documentation\n├── pyproject.toml              # Python project configuration\n├── uv.lock                     # uv lock file\n├── LICENSE                     # FreeU Community License\n├── README.md                   # This file (English)\n└── README_CN.md                # Chinese README\n```\n\n## Contributing\n\nThe FreeTodo community is possible thanks to thousands of kind volunteers like you. We welcome all contributions to the community and are excited to welcome you aboard.\n\n**Recent Contributions:**\n\n![GitHub contributors](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fcontributors\u002FFreeU-group\u002FLifeTrace) ![GitHub commit activity](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Fcommit-activity\u002Fm\u002FFreeU-group\u002FLifeTrace) ![GitHub last commit](https:\u002F\u002Fimg.shields.io\u002Fgithub\u002Flast-commit\u002FFreeU-group\u002FLifeTrace)\n\n### 📚 Contributing Guidelines\n\nWe have comprehensive contributing guidelines to help you get started:\n\n- **[Contributing Guidelines](.github\u002FCONTRIBUTING.md)** - Complete guide on how to contribute\n- **[Backend Development Guidelines](.github\u002FBACKEND_GUIDELINES.md)** - Python\u002FFastAPI coding standards\n- **[Frontend Development Guidelines](.github\u002FFRONTEND_GUIDELINES.md)** - TypeScript\u002FReact coding standards\n\n### 🚀 Quick Start for Contributors\n\n1. **🍴 Fork the project** - Create your own copy of the repository\n2. **🌿 Create a feature branch** - `git checkout -b feature\u002Famazing-feature`\n3. **💾 Commit your changes** - `git commit -m 'feat: add some amazing feature'`\n4. **📤 Push to the branch** - `git push origin feature\u002Famazing-feature`\n5. **🔄 Create a Pull Request** - Submit your changes for review\n\n### 🎯 Areas Where You Can Contribute\n\n- 🐛 **Bug Reports** - Help us identify and fix issues\n- 💡 **Feature Requests** - Suggest new functionality\n- 📝 **Documentation** - Improve guides and tutorials\n- 🧪 **Testing** - Write tests and improve coverage\n- 🎨 **UI\u002FUX** - Enhance the user interface\n- 🔧 **Code** - Implement new features and improvements\n\n### 🔰 Getting Started\n\n- Check out our **[Contributing Guidelines](.github\u002FCONTRIBUTING.md)** for detailed instructions\n- Look for issues labeled `good first issue` or `help wanted`\n- Follow **[Backend Guidelines](.github\u002FBACKEND_GUIDELINES.md)** for Python\u002FFastAPI development\n- Follow **[Frontend Guidelines](.github\u002FFRONTEND_GUIDELINES.md)** for TypeScript\u002FReact development\n- Join our community discussions in Issues and Pull Requests\n\nWe appreciate all contributions, no matter how small! 🙏\n\n## Join Our Community\n\nConnect with us and other FreeTodo users! Scan the QR codes below to join our community groups:\n\n\u003Ctable>\n  \u003Ctr>\n    \u003Cth>WeChat Group\u003C\u002Fth>\n    \u003Cth>Feishu Group\u003C\u002Fth>\n    \u003Cth>Xiaohongshu\u003C\u002Fth>\n  \u003C\u002Ftr>\n  \u003Ctr>\n    \u003Ctd align=\"center\">\n      \u003Cimg src=\".github\u002Fassets\u002Fwechat.png\" alt=\"WeChat QR Code\" width=\"200\"\u002F>\n      \u003Cbr\u002F>\n      \u003Cem>Scan to join WeChat group\u003C\u002Fem>\n    \u003C\u002Ftd>\n    \u003Ctd align=\"center\">\n      \u003Cimg src=\".github\u002Fassets\u002Ffeishu.png\" alt=\"Feishu QR Code\" width=\"200\"\u002F>\n      \u003Cbr\u002F>\n      \u003Cem>Scan to join Feishu group\u003C\u002Fem>\n    \u003C\u002Ftd>\n    \u003Ctd align=\"center\">\n      \u003Cimg src=\".github\u002Fassets\u002Fxhs.jpg\" alt=\"Xiaohongshu QR Code\" width=\"200\"\u002F>\n      \u003Cbr\u002F>\n      \u003Cem>Follow us on Xiaohongshu\u003C\u002Fem>\n    \u003C\u002Ftd>\n  \u003C\u002Ftr>\n\u003C\u002Ftable>\n\n## Documentation\n\nWe use deepwiki to manage our docs, please refer to this [**website.**](https:\u002F\u002Fdeepwiki.com\u002FFreeU-group\u002FLifeTrace\u002F6.2-deployment-and-setup)\n\n## Star History\n\n[![Star History Chart](https:\u002F\u002Fapi.star-history.com\u002Fsvg?repos=FreeU-group\u002FFreeTodo&type=Timeline)](https:\u002F\u002Fwww.star-history.com\u002F#FreeU-group\u002FFreeTodo&Timeline)\n\n## License\n\nCopyright © 2026 FreeU.org\n\nFreeTodo is licensed under the **FreeU Community License**, which is based on Apache License 2.0 with additional conditions regarding commercial usage.\n\nFor detailed license terms, please see the [LICENSE](LICENSE) file.\n","FreeTodo 是一款基于AI的智能待办事项管理应用，旨在帮助用户高效管理任务、提高生产力并达成目标。其核心功能包括通过对话式AI交互和智能任务分解将复杂项目转化为可执行步骤，提供上下文感知的任务建议等。技术特点方面，FreeTodo 采用前后端分离架构，后端使用FastAPI (Python) 提供RESTful API服务，前端则基于Next.js (React + TypeScript) 构建现代化网页界面，并利用SQLite与ChromaDB支持AI特性。此外，它还具备多视图日历、丰富的笔记记录以及美观且响应式的用户界面设计。这款应用程序适合需要提升个人或团队工作效率、更好地规划日常任务与长期项目的场景使用。",2,"2026-06-11 03:47:51","high_star"]