karakeep README

The project's README from github.com/karakeep-app/karakeep. As one markdown file: README.md.

GitHub Actions Workflow Status GitHub Release Discord Translation status

Karakeep (previously Hoarder) is a self-hostable bookmark-everything app with a touch of AI for the data hoarders out there.

homepage screenshot

Features

Documentation

Demo

You can access the demo at https://try.karakeep.app. Login with the following creds:

email: [email protected]
password: demodemo

The demo is seeded with some content, but it's in read-only mode to prevent abuse.

About the name

The name Karakeep is inspired by the Arabic word "كراكيب" (karakeeb), a colloquial term commonly used to refer to miscellaneous clutter, odds and ends, or items that may seem disorganized but often hold personal value or hidden usefulness. It evokes the image of a messy drawer or forgotten box, full of stuff you can't quite throw away—because somehow, it matters (or more likely, because you're a hoarder!).

Stack

Why did I build it?

I browse reddit, twitter and hackernews a lot from my phone. I frequently find interesting stuff (articles, tools, etc) that I'd like to bookmark and read later when I'm in front of a laptop. Typical read-it-later apps usecase. Initially, I was using Pocket for that. Then I got into self-hosting and I wanted to self-host this usecase. I used memos for those quick notes and I loved it but it was lacking some features that I found important for that usecase such as link previews and automatic tagging (more on that in the next section).

I'm a systems engineer in my day job (and have been for the past 7 years). I didn't want to get too detached from the web development world. I decided to build this app as a way to keep my hand dirty with web development, and at the same time, build something that I care about and use every day.

Alternatives

Translations

Karakeep uses Weblate for managing translations. If you want to help translate Karakeep, you can do so here.

Karakeep Cloud ☁️

If you're not comfortable with self-hosting, you can use our managed Karakeep cloud at cloud.karakeep.app. Cloud subscriptions support the development of Karakeep.

Support

If you're enjoying using Karakeep, drop a ⭐️ on the repo!

Buy Me A Coffee

Community Channels

License

Karakeep is licensed under AGPL-3.0 and owned by Localhost Labs Ltd.

Star History

Star History Chart

karakeep (karakeep-app/karakeep)

Searching Database…

29.8K ·GitHub
这是什么?Karakeep(原名 Hoarder)是一个可以自托管的书签收藏应用:可以保存链接、笔记、图片和 PDF,它会自动抓取链接详情,用大语言模型自动打标签,并支持对所有内容的全文搜索和语义搜索。
它是手机应用、浏览器扩展,还是网站?它是一个运行在你自己服务器上的网页应用。围绕这个核心,还有 Chrome、Firefox 和 Safari 浏览器扩展方便快速收藏,支持离线阅读的 iOS 和 Android 应用,以及一个 REST API 和多个客户端。
我怎么把它跑起来?按照安装文档把它部署到自己的服务器上(Docker 是标准方式),然后把浏览器扩展或手机应用指向你的实例。安装之前还可以先看看带预置数据的只读演示版。
自动打标签功能需要 OpenAI API 密钥吗?不一定:打标签和摘要都依赖大语言模型(默认方案里用的是 OpenAI),但也支持通过 Ollama 使用本地模型,所以这些 AI 功能完全可以不花钱、不接任何付费 API 就能用。
我必须自己架服务器吗,还是有托管版本?自托管是主要方式,所以实例要由你自己维护——换来的是数据留在你自己的设备上。如果不想折腾,官方提供的替代方案是托管版的 Karakeep Cloud(cloud.karakeep.app),靠付费订阅维持运营。
我到底能往里面存什么——只有链接吗?链接、简单笔记、图片和 PDF 都可以。对链接会自动抓取标题、描述和图片;你可以把收藏整理进列表(共享列表支持多人协作),做标注高亮,还能从 Chrome、Pocket、Linkwarden、Omnivore 和 Tab Session Manager 导入已有的书签。
搜索是怎么工作的——能搜到图片里的文字吗?所有存储的内容都支持全文搜索和语义搜索,而且 OCR 能从图片中提取文字,连截图也变成可搜索的。底层搜索由 Meilisearch 驱动。
收藏的链接以后失效了怎么办?这个也考虑到了:Karakeep 用 monolith 做整页存档来防止链接失效,还会用 yt-dlp 自动存档视频。
作者为什么不直接用 Pocket,而要自己开发这个?作者以前总把 Reddit、Twitter 和 Hacker News 上看到的内容存下来,等有空在笔记本上慢慢读,后来玩起了家庭服务器(home lab),就想把这种“稍后阅读”的流程改成自托管。Pocket 又即将关停,于是他做了 Karakeep 当作自己天天在用的工具——顺便保持对 Web 开发的手感。
Size
102 MB
Stars
29.8K
Age
2y
Commits · 90 Days