English | 中文

<div align="center"> <!-- Huntly Logo & Title --> <img src="app/extension/public/favicon-128x128.png" alt="Huntly" width="120" />

Huntly

Your Personal AI-Powered Information Hub

Self-hosted information hub with a powerful browser extension that captures, processes, and organizes web content using AI — turning your browsing into actionable knowledge.

<!-- Badges -->

🤖 AI-Powered · 🔒 100% Self-Hosted · 🚀 Multi-Platform

Website · Documentation · Download

</div>

Features

[!TIP] This project is under rapid development. Recommend using Docker with automatic updates (such as Watchtower) to stay on the latest version.

Feature	Description
🤖 AI Content Processing	Leverage AI for summarization, translation, browser extension chat, and intelligent content analysis with custom shortcuts
🔌 MCP & Agent Skills	MCP server + Agent Skills for AI assistants to search your knowledge base, RSS feeds, tweets, and highlights. Install via npx skills add lcomplete/huntly
📚 Web Archiving	Automatically save and archive web pages with content extraction using Defuddle and Mozilla Readability
📡 RSS Feed Management	Centralize all your RSS feeds with intelligent categorization, OPML import/export, and full-text search
🔍 Powerful Full-Text Search	Apache Lucene with IK Analyzer for Chinese text tokenization, boolean operators, and fuzzy search
🐦 Social Media Integration	Special handling for Twitter/X with automatic tweet thread reconstruction and media preservation
⭐ GitHub Integration	Sync and organize your GitHub stars with repository metadata and README extraction
🔒 Privacy & Self-Hosting	100% self-hosted with SQLite database, Docker deployment, and complete data ownership
💻 Multi-Platform Support	Web app, Chrome extension (Manifest V3), and desktop apps (Tauri)

Roadmap

• Export all saved content to Markdown
• Flexible Organization: Collections
• Enhanced extension with standalone AI processing (no server required)
• Built-in browser extension chat with page context, attachments, and AI shortcuts

Screenshot

Getting Started

Step 1: Install the Browser Extension

The browser extension is essential for automatically saving web pages and Twitter content.

Chrome:

• Install from Chrome Web Store

Step 2: Run the Server

Choose one of the following methods to run the Huntly server:

Option A: Docker Compose (Recommended)

Create a docker-compose.yml file:

version: '3.8'

services:
  huntly:
    image: lcomplete/huntly
    container_name: huntly
    restart: always
    ports:
      - "8088:80"
    volumes:
      - ~/data/huntly:/data
    labels:
      - "com.centurylinklabs.watchtower.enable=true"

It's recommended to use Watchtower for automatic updates to get the latest features.

Then run:

docker-compose up -d

Option B: Desktop Client

Download the installation package for your operating system from Releases and run it after installation.

If you encounter the error message "Huntly.app" is damaged and can't be opened on macOS, run:

sudo xattr -r -d com.apple.quarantine /YOUR_PATH/Huntly.app

See the Run the Server wiki for more options.

Step 3: Configure Extension & Login

1. Click the Huntly extension icon and set the server address. For remote access, it is highly recommended to use HTTPS for privacy.
2. Open the Huntly website for the first time to register an administrator user
3. After registration, you will be automatically logged in, and the extension will sending only relevant browsing data (such as saved pages and tweets) to the server.

Enjoy it!

Contributing

Contributions are welcome.

• Check existing issues and pull requests before starting to avoid duplicate work.
• Open an issue or discussion first for larger changes so the approach can be aligned.
• Keep pull requests focused and include a clear description, test notes, or screenshots when relevant.
• Update related documentation and tests when your change affects behavior or user workflows.

Become a Sponsor

If you find Huntly helpful, please consider supporting its development!

<p align="center"> <img height="360" src="static/images/wechat.JPG" /> <img height="360" src="static/images/zfb.JPG" /> </p>

Sponsors

Thank you to all our sponsors for your generous support!

<table> <tr> <td align="center"><a href="https://www.augmentcode.com/">augment code</a></td> <td align="center"><a href="https://www.jetbrains.com/">jetbrains</a></td> <td align="center"><a href="https://taresky.com/">TARESKY</a></td> <td align="center"><a href="https://x.com/Db9el25LULCBrcn">抹茶</a></td> <td align="center"><a href="https://github.com/jtsang4">jtsang4</a></td> </tr> </table>

---

<div align="center">

✨ Special Thanks To ✨

<a href="https://www.augmentcode.com/"> <img src="static/images/sponsor/augment.png" alt="Augment Code" height="100" /> </a>

Augment Code - Better Context. Better Agent. Better Code.

</div>