Workspace
Blog

How to Install Beeblio on Your Computer

3 Nov 2026·

Install the open source Beeblio desktop app on Apple Silicon macOS or Windows, handle unsigned installer warnings, and set up your first local research workspace.

The open source edition of Beeblio runs on your computer, with a desktop window for your research files, documents, and Eve, the AI assistant. You can install the desktop build without checking out the source code or setting up Node.js.

Choose the right download

Go to the Beeblio GitHub Releases page, open the release marked Latest, and expand Assets. Download the installer for your computer:

ComputerDownload
Apple Silicon Mac (macOS 12 or later)Beeblio-<version>-mac-arm64.dmg
Windows x64Beeblio-<version>-win-x64.exe

The current release also has update files such as .blockmap and .yml; those are not the installers. The desktop release does not currently include an Intel Mac or Linux installer. If you use Linux, the source instructions in the README are the way to run the local app.

Install on macOS

  1. Open the downloaded .dmg and drag Beeblio into Applications.
  2. Open Beeblio from Applications. Because this community-built release is not yet signed and notarized with Apple, macOS may say it cannot verify the developer or check the app for malicious software.
  3. If you trust the download you got from the project's GitHub release, dismiss that alert. Open System Settings → Privacy & Security, scroll to the security message about Beeblio, and click Open Anyway. Confirm Open when macOS asks again. Apple documents this per-app override; you do not need to disable Gatekeeper for all apps.

If macOS says the app is damaged or will damage your computer, do not treat that message as the routine unsigned-app warning. Delete that copy, download it again from the official release, and check the release or report the problem before trying another workaround. Apple's guidance notes that a damaged-app warning can also mean the app was modified or contains malware.

Install on Windows

Run the .exe from the release's Assets. If Windows SmartScreen shows Windows protected your PC, check that the file came from the project's GitHub release, then choose More info → Run anyway if you trust it. The installer is currently unsigned and installs for your user account without administrator rights.

Set up your first workspace

On first launch, Beeblio's welcome flow asks for your OpenRouter API key and a main model, then helps you create a project. Link an existing folder: Beeblio works with the files there and adds its standard research folders and starter files where they are missing. You can reopen the tour later from Show tour in the account menu or Help → Show Tour.

The desktop app bundles its own runtime. Optional tools, such as Python, Pandoc, LibreOffice, and a TeX distribution for compiling LaTeX to PDF, are installed separately if your workflows need them. Settings → System Tools shows what Beeblio can find on your computer.

Your project files stay in the folders you link. Desktop application data lives in ~/Library/Application Support/Beeblio/Data on macOS or %APPDATA%\Beeblio\Data on Windows. Beeblio can call the external model and research services you configure, so “local” does not mean every AI request runs offline. For more detail on the local edition, see the open source README and our introduction to Beeblio Open Source.

Beeblio Cloud at beeblio.org is the separate hosted version, with cloud compute and cloud storage. If you want the community-built desktop app, start with the latest GitHub release.

Beeblio Team

beeblioopen-sourcedesktopinstallation

The Premise

Why we're building a full-stack research workspace — and finishing the job the IDE started.