LoupistGitHubDownload

Loupist Docs

Search Loupist Docs

Browse all pages or type to search

Get startedOverviewLearn what a Loupist keeps, how it uses evidence, and where to begin your first research question.Get startedQuickstartInstall Loupist, connect an AI account, and check the evidence behind your first answer.Get startedInstall and verify the BetaInstall the macOS Beta and check that the download matches the public release workflow.Get startedConnect an AI accountConnect the account or API key that will answer your questions, and understand which work uses it.Get startedCreate a LoupistCreate a separate research companion with its own focus, conversations and Memory.Core conceptsHow a Loupist learnsFollow the path from a retained original to a method used in a later answer, and inspect what changed.Core conceptsMemory recordsTell retained evidence, analysis and your own judgments apart, and find each record in the app.Core conceptsWorld and MapTrace a relationship to its evidence, navigate your Map, and export an image or growth replay.Core conceptsLens and your principlesTeach a research rule, inspect pages built from evidence, and see why a learned method changed.GuidesFollow assets and import holdingsBuild the list your research uses, import a holdings snapshot, and distinguish following from automatic checks.GuidesWatching and alertsChoose automatic checks, inspect their source coverage, and pause or refresh them without an AI call.GuidesBriefings and ScheduleCreate timed research in Bot, inspect the result, and control future runs from Schedule.GuidesBot and research sessionsUse Bot for ongoing work and open a separate research session for a question that needs its own conversation.GuidesRead an answerCheck a finding against its original sources, inspect calculated figures, and distinguish a receipt from proof of correctness.GuidesRun calculations with run_pythonAsk for reproducible numerical work and inspect its code, files and limits.GuidesJournal entries and later reviewsRecord your own judgment with an optional dated check, then compare it with later evidence.GuidesPrivate chatTurn off Memory use and saving for a conversation while understanding what still persists and leaves your Mac.GuidesData connectionsSet up a built-in source or a custom read-only service and choose which Loupists may use it.GuidesMove or back up a LoupistPreserve a Loupist folder, reopen its saved identity, and know which shared settings need separate setup.ReferenceData sourcesFind the source for a research task and identify the setup or coverage to check before using it.ReferenceKeyboard and command paletteNavigate the app and find research without the mouse, with the current shortcut list available in Settings.ReferenceSettingsFind the right settings scope for accounts, defaults, appearance and a single Loupist.ReferenceWhat leaves your Mac and securityCheck which requests leave your Mac, where credentials stay, and what the app permits research tools to do.ReferenceUpdates and Beta limitsCheck for an update, understand version compatibility, and confirm the supported Beta platform.ReferenceTroubleshooting and FAQRecover from common setup, account, source and schedule problems without treating missing evidence as a successful check.ReferenceLicenceFind the terms for the app, distinguish them from data-provider rights, and keep private research separate from code licensing.

↑ ↓ navigate · Enter opens · Escape closes

Get started

Install and verify the Beta

Install the macOS Beta and check that the download matches the public release workflow.

Supported Mac#

Loupist supports macOS 13 Ventura or newer on Apple Silicon. Windows, Intel Macs and Linux are not supported. The Beta is signed with Loupist's own certificate and is not notarized by Apple.

First launch#

  1. Get Loupist-macOS-arm64.dmg from the release page, open it, and drag Loupist to Applications.
  2. Open Loupist from Applications. On macOS 13 or 14, close the warning with OK. On macOS 15 or newer, choose Done. Do not choose Move to Trash.
  3. Open System Settings → Privacy & Security. Scroll to Security and choose Open Anyway beside Loupist. On macOS 15 or newer, confirm Open Anyway again.
  4. Enter your Mac login password if requested and choose Open if asked. Later launches open normally.

The Open Anyway button is shown for about an hour after the blocked launch. If it is gone, try opening Loupist again first. The macOS message saying the software needs an update does not mean your download is old.

Verify the file#

Download SHA256SUMS from the same release. Compare its value with:

sh
shasum -a 256 ~/Downloads/Loupist-macOS-arm64.dmg

With the GitHub CLI installed, verify build provenance:

sh
gh attestation verify ~/Downloads/Loupist-macOS-arm64.dmg \
  --repo loupistai/loupist \
  --signer-workflow loupistai/loupist/.github/workflows/release.yml

After installation, inspect the signature. Compare the certificate fingerprint with RELEASE-METADATA.json from the release or the repository's release profile.

sh
codesign -d -r- /Applications/Loupist.app

Keep a copy before updating#

Compatible saved data is upgraded in place after a private database backup. Downgrading is not supported. See Updates and Beta limits before changing versions.

Based on the app’s source documentation and English interface labels. Report a docs issue.