An open API service indexing awesome lists of open source software.

https://github.com/lcomplete/huntly

Your Personal AI-Powered Information Hub
https://github.com/lcomplete/huntly

extension-chrome github pocket react rss rssreader selfhosted twitter

Last synced: 6 days ago
JSON representation

Your Personal AI-Powered Information Hub

Awesome Lists containing this project

README

          

**English** | [中文](./README.zh.md)

✨ Special Thanks To ✨


Augment Code

**[Augment Code](https://www.augmentcode.com/)** - Better Context. Better Agent. Better Code.

---

Huntly

# 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.

[![GitHub stars](https://img.shields.io/github/stars/lcomplete/huntly?style=flat-square)](https://github.com/lcomplete/huntly/stargazers)
[![GitHub license](https://img.shields.io/github/license/lcomplete/huntly?style=flat-square)](https://github.com/lcomplete/huntly/blob/main/LICENSE)
[![Docker Pulls](https://img.shields.io/docker/pulls/lcomplete/huntly?style=flat-square)](https://hub.docker.com/r/lcomplete/huntly)
[![DeepWiki](https://img.shields.io/badge/DeepWiki-lcomplete%2Fhuntly-blue?style=flat-square&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAC/klEQVR4nMSXz0tUURTHP+fe9+bNvBnTMRudhIoWtWgRtGoRBK2C/oAg2rUuiGpZy4L+hyC6bdu2TYto4aJFSFAQlRq5yKwZHfPNvPvj3BYzjjo/3ryZFvfAg8c793zP955z7r0PiijvdHd8FMrDVuD8RV5wLI9IPgRO9nS8e1d+wWGok1hOiHhWvkfO7wC72vrOlvMF5EPlr93dN4Z//XE5Dxj5v37AB8B/5r+6OoqCkGrzot4kvjMwQXOitR3V7qdl5AIBkP9I6kEkCvLj6/vO1kuLKhfzoblG+c2t7+33Z4pทDy9zqXOm5MLGHLf0Nff/WBTM7hnOw0HAfmi0I2xPY+EiC49ptvzPfFl79dfuP4j6VZsV9LXDK05Y4E0X3MjapuO6XFB0e5EIQ+GRWK07HuvuLLbp0Z3e+6Q9UXbnDVAT5A3pJYLYBKiT0EthbZJ1nv2ptvNXP9f7V/0kVW6rEq8F4z0NDK2l3fvt+oJPLQ4vGTe6FDypPxhgJuI3GEh4xzzWVFf5WPL2mG7xgpCRG0WaFVXJQnGqhxYU5cD1w/uZHpqVGvqbIQ4IWP/5h5WBBa1v9E2KQ4MhMD29NnNp/OeS1F44F3xz/UjTuIAEXhEHGfnCsS0KxCqXx0a0/MYjPn/SDRkLPpAQ8j8OD8L0+7XwC0Y/SXMEaLGp8nKCsN9tFllZBzgKDoYl3A2opVLOhON4Q0yMRhC0gC8gIIEQxsgnT/BDBVAI8c0PGz/HUe3CMR4IYJzGPL3J5D2DFDqg7TaXQBhYRQRTACHFE1HJLdHXx2WOFbzBhSoJxjERYCxl4E9RguNm7Ef/0M+rPsxc/1vynI4IfS76gVCNORbzR+E1BBEQS8Kg89BoF49OtfD4FFGBERHhJcTl1NB5i8m0fXp3q+7z+PKN8DL/r7OmjE8DYZWKYwYj6r3aNNQMJL6mLlX49p0VFrJ3nLsN4E7ER7G6PKNG04ApWsX+CNa3ftJsj+/ufA/+Q9KJjqMfxJPj1PkZ/B7N4j6QAAAABJRU5ErkJggg==)](https://deepwiki.com/lcomplete/huntly)

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

[Website](https://huntly.codelc.com) · [Documentation](https://huntly.codelc.com/docs) · [Download](https://huntly.codelc.com/download)

## 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, and intelligent content analysis with custom shortcuts |
| 🔌 **MCP Server Integration** | Built-in Model Context Protocol (MCP) server enabling AI assistants (Claude, Cursor, etc.) to access your knowledge base, search content, and retrieve RSS feeds, tweets, GitHub stars, and highlights |
| 📚 **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

- [x] Export all saved content to Markdown
- [x] Flexible Organization: Collections
- [x] Enhanced extension with standalone AI processing (no server required)

## Screenshot

![screenshot-home](static/images/screenshot-home.png)

![screenshot-feeds](static/images/screenshot-feeds.png)

![screenshot-library](static/images/screenshot-library.png)

![extension_shortcuts](static/images/extension_shortcuts.png)

## 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](https://chrome.google.com/webstore/detail/huntly/cphlcmmpbdkadofgcedjgfblmiklbokm)

### 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:

```yaml
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](https://containrrr.dev/watchtower/) for automatic updates to get the latest features.

Then run:

```sh
docker-compose up -d
```

#### Option B: Desktop Client

Download the installation package for your operating system from [Releases](https://github.com/lcomplete/huntly/releases) and run it after installation.

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

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

See the [Run the Server wiki](https://github.com/lcomplete/huntly/wiki/Run-the-Server) 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!**

## Become a Sponsor

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

[![Sponsor](https://img.shields.io/badge/Sponsor-Click%20Here-ff69b4)](https://github.com/sponsors/lcomplete)




### Sponsors

Thank you to all our sponsors for your generous support!


augment code
jetbrains
TARESKY
抹茶