LiteMark

LiteMark is a personal bookmark and navigation management system built with Vue 3 and FastAPI. It targets users seeking an organized, intelligent, and flexible solution for managing web links, offering a responsive dual-interface, an admin panel, and AI-driven features.

How It Works

The system combines a Vue 3 frontend with a FastAPI backend. Its core design emphasizes user-friendly management via a dedicated admin panel, enhanced by AI for smart categorization, content summarization, and tag extraction. Data integrity is maintained through WebDAV timed backups and versatile import/export capabilities (JSON, CSV, HTML). An integrated Streamable HTTP MCP Server enables programmatic bookmark management for AI clients.

Quick Start & Requirements

• Primary Install: Docker (recommended).
• Commands: curl -O https://raw.githubusercontent.com/topqaz/LiteMark/main/docker-compose.yml followed by docker-compose up -d. Supports x64 and ARM64 architectures.
• Access: Main UI at http://localhost:8080, admin panel at http://localhost:8080/admin.
• Default Admin Credentials: admin / admin123.
• Prerequisites: Docker, Docker Compose.
• Configuration: Key environment variables include JWT_SECRET (must be changed for production), DATABASE_URL, DEFAULT_ADMIN_USERNAME, DEFAULT_ADMIN_PASSWORD.
• Links: docker-compose.yml, Browser Extension.

Highlighted Details

• AI-Powered Features: Intelligent category recommendations, content summarization, tag extraction, and quick bookmark adding.
• WebDAV Timed Backup: Automatic, scheduled backups to a configured WebDAV server.
• Multi-Format Import/Export: Bookmarks import/export via JSON, CSV, or HTML (Netscape) formats.
• MCP Tool Integration: Streamable HTTP MCP Server for programmatic bookmark management via Bearer Token or OAuth 2.0.
• Reverse Proxy Configuration: Detailed Nginx examples provided for MCP service, requiring specific settings for long connections, buffering, and headers.

Maintenance & Community

The project welcomes Issues and Pull Requests. No specific details on maintainers, sponsorships, or dedicated community channels are provided.

Licensing & Compatibility

No license information is explicitly stated in the provided README, potentially impacting commercial use.

Limitations & Caveats

Proper reverse proxy configuration is critical for the MCP service. Default administrative credentials and JWT secret require updating for production. The absence of explicit licensing is a potential adoption blocker.