CleanBook

English

中文

English

中文

Theme

CleanBookSmart Bookmark Cleaner & Classifier

Rules-first, ML-assisted, LLM-optional. Offline-ready browser bookmark organization tool.

Quick Start
Architecture
GitHub
CleanBook Logo
🚀

Offline-First

Complete cleaning, deduplication, classification and export without cloud services. Perfect for local batch processing and long-term maintenance. Rule engine responds in sub-milliseconds.

⚙️

Config-Driven

Adjust rules, thresholds and directory organization via config.json and vocabulary files. No code changes needed. YAML vocabularies support controlled vocabulary and faceted classification.

🤖

Progressive Enhancement

Layer ML, semantic analysis and optional OpenAI-compatible LLM on top of rules. Automatic fallback when services are unavailable. No worries about service availability.

📦

Multi-Format Export

Export to HTML, Markdown, JSON and more. Supports browser re-import, knowledge base archiving, and further processing needs.

🔧

CLI-First

Provides cleanbook CLI tool and cleanbook-wizard interactive interface. Supports batch processing and automation integration.

📊

Smart Classification

Multi-level feature extraction based on domain, title, and URL. Fusion of rule engine and machine learning achieves 91.4% classification accuracy.

Project Positioning ​

CleanBook targets the scenario of "long-term browser bookmark maintenance": start with cleaning, deduplication and normalization, then organize links into stable, readable, and sustainably evolving classification structures based on rules and models.

Who is it For ​

  • Individual Users: Heavy browser users who want to organize bookmarks offline first, then optionally introduce ML/LLM
  • Team Maintainers: Technical leads who need unified team bookmark classification rules, vocabularies and output formats
  • Developers: Open source contributors who want to understand bookmark processing pipelines, classification fusion and configuration-driven design

Where to Start ​

  1. Read the Quick Start guide to complete a minimal run
  2. Review Best Practices to establish classification rules and organization habits
  3. When you need to understand the implementation, continue reading System Architecture and Development Guide

I just want to organize my bookmarks

I want to understand how the system works

I want to contribute to development

Core Documentation ​

CategoryPageDescription
Quick StartQuick StartInstallation, minimal example, common parameters
User GuideBest PracticesConfiguration ideas, directory organization and maintenance tips
ArchitectureDesign Overview / System ArchitecturePipeline, module boundaries and classification strategies
DevelopmentDevelopment GuideEnvironment setup, testing and extension points
ReferenceLLM TemplatesPrompt structure and optional interface configuration
ArchiveTechnical ReportHistorical supplementary materials and extended notes

Released under MIT License

Copyright © 2025-2026 LessUp