Spyglass logo

Spyglass athlabs

Use this command to install Spyglass:
winget install --id=athlabs.Spyglass -e

A personal search engine.

Spyglass: A Personal Search Engine

Primary Purpose:
Spyglass is a personal search engine designed to create a searchable library from your personal documents, interests, and more. It allows you to index content directly on your device, providing fast and efficient access to information.

Key Features:

  • Indexing Sources: Organize and search through local documents, internet topics, developer resources like Rustlang and Go, Wikipedia entries, game wikis, Google Calendar events, Drive files, GitHub repositories, Reddit saves, Gmail, and YouTube playlists.
  • Private Data Integration: Seamlessly incorporate private data into your searchable library for enhanced privacy and control.

Audience & Benefit:
Ideal for users who are dissatisfied with traditional search engines, Spyglass offers a tailored solution to find exactly what you want. It provides greater control over your search experience, enhances privacy, and delivers faster, more relevant results.

Installation:
Available via winget for easy installation across multiple platforms.

Spyglass empowers you to build a personal knowledge base that prioritizes your needs and preferences.

README

Spyglass

A personal search engine that indexes what you want, exposing it to you in a simple & fast interface

    Download now:
    <a href="https://github.com/spyglass-search/spyglass/releases/download/v2023.4.1/Spyglass_23.4.1_universal.dmg">
        <strong>macOS (Intel/ARM)</strong>
    </a> |
    <a href="https://github.com/spyglass-search/spyglass/releases/download/v2023.4.1/Spyglass_23.4.1_x64_en-US.msi">
        <strong>Windows</strong>
    </a> |
    <a href="https://github.com/spyglass-search/spyglass/releases/download/v2023.4.1/spyglass_23.4.1_amd64.AppImage">
        <strong>Linux (AppImage)</strong>
    </a>


<a href="https://docs.spyglass.fyi">
    <strong>Documentation</strong>
</a> |
<a href="https://docs.spyglass.fyi/usage/index.html">
    <strong>Using Spyglass</strong>
</a> |
<a href="https://docs.spyglass.fyi/usage/lenses/index.html">
    <strong>Lenses</strong>
</a>


<img src="https://github.com/spyglass-search/spyglass/actions/workflows/rust.yml/badge.svg" />
<a href="https://discord.gg/663wPVBSTB"><img src="https://img.shields.io/badge/Discord-Join%20Now-blue" /></a>


<img src="docs/spyglass-showcase.gif" />

Create your library from:

  • Local documents/folders
  • Different internet topics (https://lenses.spyglass.fyi).
    • Lots of developer docs (Rustlang, Go, etc.)
    • Wikpedia, game wikis, etc.
  • Google Calendar events.
  • Google Drive docs.
  • GitHub repos, starred repos, & issues.
  • Reddit saved/upvoted posts.
  • Gmail
  • YouTube playlists & favorited.

Introduction

Spyglass lives on your device crawling & indexing websites you want with a basic set of rules.

Web pages when condensed down to text are surprisingly small. With todays' incredibly fast CPUs and ample amounts of of disk space, you can easily create a personal library of wikis, blog posts, etc. that can be referenced instantly. Cut through the SEO spam of the internet by building your own index.

For users who have been frustrated with the current state of search and the internet, Spyglass offers a powerful solution to find exactly what you want.

> See Launching & Using Spyglass to get started.

Traditional web search sucks

> The short answer is that Google search results are clearly dying. The long answer > is that most of the web has become too inauthentic to trust. > > - https://dkb.io/post/google-search-is-dying

Spyglass is a solution to the following common issues when searching the web:

  • Do you add terms such as reddit or wiki to your searches to narrow it down?
  • Do you get frustrated with overzealous autocorrect on your search terms?
  • Do you get frustrated with the terrible search some wikis/sites offer?
  • Do you scroll past dozens of SEO spam pages to find the recipe/review/blog post you were looking for?
  • Do you skip over a full-page of ads before getting to your actual search results?
  • Do you have private websites / data / documents that you'd like to search through?

How does it know what to crawl?

Spyglass expands on the ideas outlined in this paper by the Brave Search Team. There are currently a simple set of rules that will point Spyglass at a website and crawl only what you want. When available, crawling is bootstrapped w/ data from the Internet Archive to not overwhelm smaller websites.

For community lenses, we precrawl & preprocess these lenses so that you can get started searching through those topics immediately.

Not all websites & not all data can be crawled by Spyglass. If you have something that you'd like to index and would like some help, feel free to ping me on our Discord server!

> See Community Lenses to install > lenses others in the community have built.

> See Building your own lens to see > how easy it is to build your own lens. Please share w/ the community when you're done!

Developer Guide

If you'd like to help, reach out on our Discord server to see what is currently being developed and how you can help usher in a new, better search.

> See Building from source to get started > building & contributing to Spyglass.

TL;DR: If you want to build and run Spyglass from source, you can simply run this command:

cargo make run
Versions
2024.11.1
23.11.1
23.5.1
22.8.2
22.8.1
22.7.4
22.7.3
22.7.2
22.7.1
22.6.5
Website
License