bibliogenius
BiblioGenius 📚
Your library, your rules. A decentralized, privacy-first personal library manager.
🎯 I Want To
| Goal | Go To Repository |
|---|---|
| 🚀 Set up my dev environment | bibliogenius-env (Start here!) |
| 📱 Use the App | bibliogenius-app (iOS, Android, Desktop) |
| ⚙️ Hack the Backend | bibliogenius (Rust Core) |
| 📖 Read Docs | bibliogenius-website (Website) |
✨ What is BiblioGenius?
BiblioGenius is a self-hosted ecosystem for managing your personal book collection and sharing it with your network.
- 📖 Catalog your books via ISBN scan or manual entry
- 🔄 Sync across devices on your local network
- 🤝 Share with friends on local network, or globally via encrypted relay
- 🔐 End-to-End Encryption - the server never sees your data
- 💾 Encrypted backups with auto-scheduler and 24h rollback
- 📚 Loans & borrowings with due-date reminders
- 🏛️ Optional public directory with consent-based discovery
- 🤖 Speak with your library using MCP (Model Context Protocol) for local AI
- 🏆 Gamification - earn badges and level up your librarian status
- 🔒 Privacy-first - Digital Sovereignty by design
📱 Supported Platforms
- ✅ macOS
- ✅ iOS
- ✅ Android
- ✅ Linux - download the AppImage (SHA256)
- 🧪 Windows - experimental installer (SHA256)
Note: Desktop builds are uploaded manually and may trail the latest mobile/macOS release by a version or two. For the newest code, build from source - see the Quick Start below.
🚀 Quick Start for Developers
bibliogenius-env is the development environment orchestrator. It clones the right repos, checks prerequisites, and configures your AI tools, all in one command.
# 1. Clone the environment repo
git clone https://codeberg.org/bibliogenius/bibliogenius-env.git
cd bibliogenius-env
# 2. Run setup for your profile
make setup P=junior # or: no-code / senior
# 3. Follow the on-screen instructions (build backend, run app, etc.)
Profiles at a glance:
| Profile | Who | What gets cloned |
|---|---|---|
no-code |
PO, PM, designer | App + Docs (translations, themes, curated lists) |
junior |
Developer with guardrails | App + Backend + Docs |
senior |
Experienced developer | Everything (incl. Hub & Docker) |
Note
: The setup script also configures Claude Code and Cursor for your profile. Re-run
make setup P=<profile>anytime to switch profiles.
🤝 Contributing
We welcome contributions! Check out our Contributor Space for good first issues and onboarding guides.
- Issues: Open a ticket in the relevant repository.
- Good First Issues: Perfect for first-time contributors - translations, documentation, and more.
📄 License
This project is licensed under the GNU Affero General Public License v3.0 - see the LICENSE file for details.
Made with ❤️ by Federico CALO