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.7K ·GitHub
Что это такое?Karakeep (раньше назывался Hoarder) — это приложение для самостоятельного размещения, куда можно сохранять всё подряд: ссылки, заметки, картинки и PDF. Оно само подтягивает данные по ссылкам, автоматически расставляет теги с помощью LLM и даёт полнотекстовый и семантический поиск по всему сохранённому.
Это мобильное приложение, расширение для браузера или сайт?Это веб-приложение, которое вы запускаете на своём сервере. Вокруг него есть расширения для Chrome, Firefox и Safari для быстрого сохранения, приложения для iOS и Android с чтением офлайн, а также REST API с множеством клиентов.
Как его запустить?Разверните его на своём сервере по документации Installation (стандартный путь — Docker), затем укажите браузерное расширение или мобильное приложение на свой сервер. Перед установкой можно осмотреться в демо с предзаполненными данными в режиме только для чтения.
Для автоматических тегов нужен ключ OpenAI API?Не обязательно: теги и пересказы делает LLM (OpenAI входит в стандартный набор), но поддерживаются и локальные модели через Ollama, так что функции ИИ могут работать вообще без платного 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, чтобы почитать позже с ноутбука, а увлёкшись домашними серверами, захотел перенести формат «сохранить на потом» на свой сервер. Pocket закрывается, поэтому он сделал Karakeep как инструмент, которым пользуется каждый день — и заодно чтобы не терять навык веб-разработки.
Size
101.6 MB
Stars
29.7K
Age
2y
Commits · 90 Days