You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
Arsen Musayelyan f45802f372
Add comments
12 months ago
internal/cards Add comments 12 months ago
search/web Add AGPLv3 header to all relevant files 12 months ago
templates Initial Commit 12 months ago
.gitignore Initial Commit 12 months ago
LICENSE Initial Commit 12 months ago
Makefile Initial Commit 12 months ago
README.md Add go report score to readme 12 months ago
go.mod Initial Commit 12 months ago
go.sum Initial Commit 12 months ago
main.go Add comments 12 months ago
scope.toml Update source code URL 12 months ago

README.md

Scope

A simple and minimal metasearch engine

Go Report Card


Why?

I created Scope because I felt an easy, simple metasearch engine did not exist. I was using searx, but it requires many external programs and resources, and it can often be very complex to set up, especially if not used on x86_64.


Features

Scope has the following features:

  • Per-request user agent randomization
  • Result cards
    • DuckDuckGo Instant Answers
    • Equation solver
    • Equation graphing
    • Location weather
  • Global config

Result Cards

When searching for certain queries, a card can appear in the results. This card will contain the answer to the query. These cards work by detecting key words in the query.

Calculation

The calculation card is a frontend card that solves a given equation or expression. The following queries can be used for calculations:

  • Expressions
    • calculate <expression>
  • Equations
    • solve <equation>
    • solve <equation> for <variable>
  • Integrals
    • integrate <expression>
    • integral <expression>
    • integral of <expression>
  • Derivatives
    • diff <expression>
    • derive <expression>
    • differentiate <expression>
    • derivative <expression>
    • derivative of <expression>

Plot

The plot card is a frontend card that graphs a given function. The following keywords can be used for this:

  • plot <equation>
  • graph <equation>
  • draw <equation>

Weather

The weather card is a backend card that gets results from metaweather. The following keywords can be used:

  • weather <location>
  • weather in <location>
  • <location> weather

DuckDuckGo

This card is a backend card that gets results from the DuckDuckGo Instant Answer API. It gets tried if no other card matches.


Config

The config for Scope applies to all users of the instance. There is no settings UI, as that would massively increase complexity, and the point of Scope is to be simple and minimal.

The config allows you to configure a lot most of Scope.


Static Resources

Scope's static resources are embedded in the binary. Therefore, all that's needed to run scope is the binary and the config. This does not use Cgo, so cross compiling is as easy as setting the GOARCH and GOOS libraries. While only tested on Linux, it should work on other OSes as well.


Mentions

This project uses many other projects. Those projects and the reasons for using them will be listed here: