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

Connect an AI account

Connect the account or API key that will answer your questions, and understand which work uses it.

Choose a way to connect#

During setup, choose Continue with ChatGPT or Continue with SuperGrok. Other ways to connect offers API keys, Use a model on this Mac, and Custom endpoint. Later, open Settings → AI accounts.

  1. Choose your sign-in or provider.
  2. Finish the browser sign-in, enter the SuperGrok device code, or enter your API key in the provider form.
  3. Wait for Connected. Return to Bot and send a question.

Claude connects with an Anthropic API key. Gemini and OpenRouter also use API keys. Available models depend on the connected provider and account. Loupist does not require its own account.

If sign-in does not return#

Use Open the sign-in page again or Copy the sign-in link if the browser did not open. Browser didn't come back? lets you paste the whole callback address shown after sign-in. Cancel ends the attempt. Sign-in expires after ten minutes.

If your plan is not eligible, use the API-key option offered by the app. If the account needs reconnecting, open Settings → AI accounts and reconnect it. Reload models retries a model list that could not load.

Choose a model#

The composer shows Auto unless you select a model. Auto chooses a recommended available model when a reply starts. It does not simply reuse the last answer's model. Set a saved default under Chat defaults.

The Map building model is separate from the Chat model. Background reading and method learning use your AI account too. Custom endpoints can serve Chat and briefings, but do not support Map building.

Use a model on this Mac#

The local-model option looks for Ollama, LM Studio and llama.cpp on this Mac. A model needs a known context capacity of at least 20,000 tokens. The server must already be running; this option does not install it.

Disconnecting your last AI account leaves saved chats and research readable. New answers need a connected account.

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