Skip to content
Back to search

logout-search

A web search engine that runs on your own computer. The index is a file you download; a search is answered from that file, on your machine, and is sent nowhere.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 21 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/m8software/logout-search with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/m8software/logout-search'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/m8software--logout-search/badge.svg)](/listings/m8software--logout-search)

HTML

<a href="/listings/m8software--logout-search"><img src="/api/listings/m8software--logout-search/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

# 1. Install the signed data release from Hugging Face (~11 GB download, 18 GB on disk)
python3 apps/search/installer/install.py install \
  --source hf:logoutsearch/logout-search \
  --pubkey ed25519:40502f6841e8644b8f193c10af27e5b148f74297bf6da7067115a60792d138bc \
  --dest ~/logout-search

# 2. Install the engine's Python runtime dependencies and start on 127.0.0.1:8090
pip install -r apps/search/serve/api/requirements.txt
python3 apps/search/installer/install.py start --dest ~/logout-search

The first few searches after a start take 2-5 s while the indexes come into memory; after that they take the times above.

**Optional add-ons** (same dataset, same key, each with its own licence; install after the release, then start again):

K=ed25519:40502f6841e8644b8f193c10af27e5b148f74297bf6da7067115a60792d138bc
# Stack Exchange how-to index: answer excerpts with credit on how-to searches (178 MB download, 481 MB on disk, CC BY-SA)
python3 apps/search/installer/install.py addon install se-howto --source hf:logoutsearch/logout-search --pubkey $K --dest ~/logout-search
# Wikipedia's article links and citations: more rows under the card (1.5 GB download, 5.6 GB on disk, CC BY-SA 4.0)
python3 apps/search/installer/install.py addon install wikilinks --source hf:logoutsearch/logout-search --pubkey $K --dest ~/logout-search
python3 apps/search/installer/install.py start --dest ~/logout-search

`addon list` shows what is installed and `addon remove <name>` takes one away. The measurements above were taken on our public server, which runs both add-ons.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 177 lines
  1. # logout search
  2. A web search engine that runs on your own computer. The index is a file you download; a search
  3. is answered from that file, on your machine, and is sent nowhere.
  4. - **Try it first, nothing to install:** [search.logout.cloud](https://search.logout.cloud) runs this same engine.
  5. - **Install it:** download the Linux or Windows build from the [latest release](https://github.com/m8software/logout-search/releases/latest),
  6. or run it in Docker (below). The data updates itself every day.
  7. - **Give your AI app web search without an API key:** the engine comes with an MCP connector for local-model
  8. front ends, desktop chat apps and editors (below). It is listed in the
  9. [MCP Registry](https://registry.modelcontextprotocol.io) as `io.github.m8software/logout-search`.
  10. - **Works offline** once the data is downloaded. No account, no tracking, no ads.
  11. This repository is the engine and everything used to build its data. It is published from our
  12. private working repository by copying the current files, without history.
  13. **State, 2026-11-08:** the engine runs on Linux and Windows, and in a Docker container (`apps/search/docker`, no database). The data release
  14. `proto-20261108-rc15` is signed and published as the Hugging Face dataset
  15. [logoutsearch/logout-search](https://huggingface.co/datasets/logoutsearch/logout-search), which also
  16. holds the public key and the install command. One program, `logout-search`, installs the data, starts the engine,
  17. keeps it updated and connects the browser extension; the bundles for Linux and Windows are
  18. built by `.github/workflows/bundle.yml` and attached to each release. They are not signed yet. There is no macOS
  19. build for now.
  20. ## What you need
  21. Minimums:
  22. - **Memory:** 4 GB
  23. - **Processor:** 2 cores, 2015 or newer (Intel Core 6th generation or AMD Ryzen)
  24. - **Storage:** 50 GB free, on an SSD
  25. ## Other devices and pairing
  26. A phone or another computer uses your engine through the page at search.logout.cloud. On the same network the page
  27. finds the engine; tap **Pair** once and that device reaches it from any network.
  28. - The site only introduces the page to your engine (a rendezvous). Searches do not go to the site.
  29. - The page and the engine then talk over a WebRTC data channel, encrypted from one end to the other. A paired device
  30. and the engine each prove they hold the pairing secret, so the rendezvous cannot put itself in the middle.
  31. - They connect directly when they can. When no direct path exists (the device is away from home, or the engine's
  32. computer does not accept incoming connections, as with Windows Firewall's defaults), the encrypted stream passes
  33. through a relay on our server. The relay carries it and cannot read it.
  34. The engine's side of this is `apps/search/serve/api/rtc_peer.py`.
  35. ## Web search for an AI app on the same computer
  36. An AI app that accepts MCP servers (a desktop chat app, an editor, a local-model front end) can search your engine
  37. instead of a paid search API. The app starts `logout-search mcp` itself; that program asks the engine on `127.0.0.1`
  38. and hands back titles, addresses and excerpts.
  39. ```
  40. logout-search mcp --print-config # prints the block to paste into the app's MCP settings
  41. ```
  42. - The question goes from the app to the engine on your machine and nowhere else. If the engine is not running, the
  43. tool says so. It never asks the public site instead.
  44. - Nothing is written down: neither this program nor the engine writes a search to disk.
  45. - It returns what the index holds (an excerpt of about 300 characters per page, plus a direct answer when there is
  46. one). It does not fetch pages.
  47. An app that takes an address instead (one in a container, or in the browser) connects over HTTP:
  48. `logout-search mcp --http 8091` serves `http://127.0.0.1:8091/mcp`, on this computer only, and refuses requests sent
  49. by web pages. For questions that need a whole page, give the app a page-reading tool as well (the wiki says why).
  50. Both generations of the protocol are served (2026-07-28, and the `initialize` handshake of 2025-11-25 and earlier).
  51. The code is `apps/search/installer/mcp_server.py`; the wiki page **AI apps** has the steps.
  52. ## Docker
  53. ```
  54. cd apps/search/docker && docker compose up -d
  55. ```
  56. One container (the published image `ghcr.io/m8software/logout-search`, x86-64; `docker-compose.build.yml` builds it
  57. from this source instead): the engine and the AI-app connector at `http://127.0.0.1:8091/mcp`. No database. The first start
  58. downloads the signed search data (about 11 GB, 18 GB once unpacked) into a volume; the daily update adds the add-ons
  59. and the stored answers, about 28 GB in all. The wiki page **Docker** has the
  60. details.
  61. ## Quick start (from source)
  62. ```bash
  63. # 1. Install the signed data release from Hugging Face (~11 GB download, 18 GB on disk)
  64. python3 apps/search/installer/install.py install \
  65. --source hf:logoutsearch/logout-search \
  66. --pubkey ed25519:40502f6841e8644b8f193c10af27e5b148f74297bf6da7067115a60792d138bc \
  67. --dest ~/logout-search
  68. # 2. Install the engine's Python runtime dependencies and start on 127.0.0.1:8090
  69. pip install -r apps/search/serve/api/requirements.txt
  70. python3 apps/search/installer/install.py start --dest ~/logout-search
  71. ```
  72. The first few searches after a start take 2-5 s while the indexes come into memory; after that they
  73. take the times above.
  74. **Optional add-ons** (same dataset, same key, each with its own licence; install after the release, then
  75. start again):
  76. ```bash
  77. K=ed25519:40502f6841e8644b8f193c10af27e5b148f74297bf6da7067115a60792d138bc
  78. # Stack Exchange how-to index: answer excerpts with credit on how-to searches (178 MB download, 481 MB on disk, CC BY-SA)
  79. python3 apps/search/installer/install.py addon install se-howto --source hf:logoutsearch/logout-search --pubkey $K --dest ~/logout-search
  80. # Wikipedia's article links and citations: more rows under the card (1.5 GB download, 5.6 GB on disk, CC BY-SA 4.0)
  81. python3 apps/search/installer/install.py addon install wikilinks --source hf:logoutsearch/logout-search --pubkey $K --dest ~/logout-search
  82. python3 apps/search/installer/install.py start --dest ~/logout-search
  83. ```
  84. `addon list` shows what is installed and `addon remove <name>` takes one away. The measurements above were
  85. taken on our public server, which runs both add-ons.
  86. ## What is here
  87. | Path | What it is |
  88. |---|---|
  89. | `apps/search/serve/api/` | The engine: `search_api.py` and what it loads. `Dockerfile` builds it; `Dockerfile.rtc` adds the peer that lets other devices on your network reach it |
  90. | `apps/search/docker/` | The Docker option: `Dockerfile`, `docker-compose.yml` (the published image; `docker-compose.build.yml` builds it here) and the entrypoint that installs the data and starts the engine and the AI-app connector |
  91. | `apps/search/installer/` | `logout_search.py`: the one program on a home computer (install, start, update, start at logon, browser host); `install.py`: downloads a signed data release, checks every file, makes it current (standard library only); `bundle/build.py`: the PyInstaller bundle |
  92. | `apps/search/extension/`, `extension-default/` | Browser extensions that connect a search page to the engine on the same computer |
  93. | `apps/search/release/` | How a data release is assembled, checked, signed and updated; `release/buildbox/rc9-*` and `rc9p-*` are the scripts that built the latest one; `release/hf_dataset.py` publishes it |
  94. | `apps/search/importer/`, `refresh/`, `news/` | How the data is built from its sources |
  95. | `apps/search/tools/` | Measurement: evaluation sets built from open data (`tools/evalsets/open/`), A/B scripts, benchmarks |
  96. | `tests/unit/` | Unit tests that run in this copy (`ci/run-unit-tests.sh`) |
  97. ## Reading the code
  98. - **Placeholders.** `testbox`, `buildbox`, `indexhost` and `homeserver` stand for the machines this was
  99. built and measured on; `user@jump-host`, `user@index-host` and `10.0.0.x` for their addresses.
  100. Scripts that mention them record how something was built or measured and will not run
  101. elsewhere unchanged.
  102. - **Not copied:** deployment scripts tied to our servers, build scripts of earlier releases,
  103. the public website (search.logout.cloud), the eval sets of real places, and tests that need those.
  104. ## Licence
  105. - **The code** is under the GNU Affero General Public License v3.0: [LICENSE](LICENSE).
  106. The name and logo are not covered.
  107. - **Software it runs on** is listed, with licences and what each bundles, in
  108. [apps/search/THIRD-PARTY-LICENSES.md](apps/search/THIRD-PARTY-LICENSES.md). None of it is in
  109. this repository; it is fetched when an image is built.
  110. - **Models** shipped with the engine: [apps/search/serve/api/NOTICE](apps/search/serve/api/NOTICE).
  111. - **The data** is not in this repository and is not under the AGPL. Each file of a release
  112. carries its own licence (Wikipedia text CC BY-SA 4.0, OpenStreetMap ODbL, and others); a
  113. release holds the texts and credits in `LICENSES/`. See
  114. [apps/search/release/hf/README.md](apps/search/release/hf/README.md).
  115. ## Removing a result, a picture, an excerpt or a page
  116. If you run a site, are named in a result, or hold rights in something a result shows, write to
  117. **help@logout.cloud**. Say which result, picture, excerpt or page, the search that shows it, and
  118. what you want removed. A site owner writes from an address at the site's domain.
  119. - **What we check:** that you can speak for the site or the work, and that the item is in the current
  120. release. A person reads every rights claim and every claim about a person.
  121. - **How it is applied:** the engine answers from a data release and does not fetch the live web, so a
  122. removal is made when a release is built. A computer that already installed a release gets it when it
  123. runs `logout-search update`. Until then it keeps showing the old data. Stored searches are served only
  124. for the release they were made on and for at most one day.
  125. - **What exists today:** a list of sites whose description is not shown
  126. (`apps/search/release/optout-domains.txt`); a site's own `noindex`, `nosnippet`, `max-snippet:0` and
  127. text-and-data-mining statements, which the build already honours
  128. (`apps/search/importer/docs_policy.py`); and block lists that remove whole sites from a build
  129. (`apps/search/tools/sqlite_lookups/build.py`, `stage_blocked`).
  130. - **Gaps:** there is no tracked list for removing a whole site, a card picture or a Stack Exchange or
  131. Wikipedia excerpt on request. Those are removed by hand when a release is built, or leave when they
  132. leave their source. There is no promised response time yet.
  133. ## Tests
  134. pip install -r ci/requirements-test.txt # and the zstd command
  135. bash ci/run-unit-tests.sh
  136. A test that lacks a package it needs says `SKIP` and passes; the script lists which ones
  137. skipped. Reporting a security problem: help@logout.cloud.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.