Repository navigation
Show: KaraClone — the Karakeep server API on the Cloudflare free tier (for users without a VPS) #3122
Replies: 2 comments
|
Hey, thanks for sharing. This is indeed very cool! No worries about the name, I'm good with it :) As for sharing the link, feel free to send a PR against the community projects docs and I'd happily accept it! Just the only thing to be aware of is that I don't give any compatibility promises on the internal tRPC API (that's what the public rest API is for). Luckily for you, I have to make sure that new mobile clients are still able to talk to old servers (to some reasonable extent). But this means that your implementation will have to keep up with the changes in here, otherwise clients might break :) Just make sure you're within the latest couple of versions of compatibility and you'll be fine. |
|
Thanks Mohamed, that's very generous of you! 🙏 Understood on the tRPC compatibility point — that's a fair caveat and I'll add an explicit note to the README so users know the internal tRPC API carries no compatibility promise, and that KaraClone tracks the locked client versions (currently Mobile 1.11.0 / Extension 1.2.11). I'll send a PR against the community projects docs shortly, and I'll include that caveat in the entry. |
Uh oh!
There was an error while loading. Please reload this page.
Hey everyone 👋
I built KaraClone, a from-scratch reimplementation of the Karakeep server API that runs entirely on the Cloudflare Workers free tier. I'm sharing it in case it's useful to others, and to ask whether the name/licensing is OK with you.
Repo: https://github.com/gowinder/karaclone (AGPL-3.0)
Why
I wanted to self-host my bookmarks but have no VPS or home server, and didn't want to pay for one just for this. The official Karakeep mobile app and browser extension already work great — I just needed a server for them to talk to. So KaraClone implements the subset of the protocol those clients need, on resources that cost nothing:
wrangler deployand you're done.What it does
What it is not
Two questions
If there's any concern about the AGPL or the protocol reimplementation, I'm all ears — I picked AGPL-3.0 to match upstream and the project is fully open source.
Thanks for building Karakeep — the API and the clients were a pleasure to work against. 🙏
All reactions