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.
 
 
 
 
 
 
Go to file
Alexandre Flament 6b71721ce8
Merge pull request #2106 from searxng/dependabot/pip/master/mock-5.0.1
2 days ago
.github chore: Set permissions for GitHub actions (#3225) 3 months ago
dockerfiles Let uWSGI workers and threads be adjustable from env 3 weeks ago
docs weblate: migration to https://translate.codeberg.org/ 1 week ago
examples Fix whitespaces 7 years ago
searx Merge pull request #2115 from searxng/dependabot/pip/master/flask-babel-3.0.0 2 days ago
searxng_extra Replace langdetect with fasttext 1 month ago
src/brand [simple] ImageLayout.watch: `img_load_error.svg` if img load fails 1 year ago
tests Merge pull request #2109 from ahmad-alkadri/fix/highlight-full-word 2 weeks ago
utils [fix] typos in utils/searxng.sh 3 weeks ago
.coveragerc [mod] use github actions instead of travis 2 years ago
.dir-locals.el [fix] typos / reported by @kianmeng in searx PR-3366 4 months ago
.dockerignore [fix] tidy up ignore lists .gitignore & .dockerignore 2 years ago
.gitattributes [fix] update .gitattributes 2 years ago
.gitignore SearXNG version: fix make docker 1 week ago
.nvmrc Node: update to node 16.15.1 7 months ago
.pylintrc [fix] prepare for pylint 2.14.0 8 months ago
.weblate weblate: migration to https://translate.codeberg.org/ 1 week ago
.yamllint.yml [enh] add test.yamllint - lint yaml files 2 years ago
AUTHORS.rst Feature: Pagination Widget with list of numbers. 5 days ago
CHANGELOG.rst [fix] typos / reported by @kianmeng in searx PR-3366 4 months ago
CONTRIBUTING.md reference docs.searxng.org 1 year ago
Dockerfile SearXNG version: fix make docker 1 week ago
LICENSE [fix] full AGPLv3+ license according to #382 8 years ago
Makefile [clean up] drop obsolete searx, filtron and morty install scripts 6 months ago
PULL_REQUEST_TEMPLATE.md Add PR template and contribution guidelines 3 years ago
README.rst weblate: migration to https://translate.codeberg.org/ 1 week ago
SECURITY.md [enh] add security policy 1 year ago
babel.cfg [fix] jinja/babel: WithExtension and AutoEscapeExtension are built-in now. 10 months ago
manage weblate: migration to https://translate.codeberg.org/ 1 week ago
package.json Node: update to node 16.15.1 7 months ago
pyrightconfig-ci.json [mod] add test.pyright to test & ci.test targets 1 year ago
pyrightconfig.json [fix] pyrightconfig.json include only dedicated folders in the test 1 year ago
requirements-dev.txt Bump mock from 5.0.0 to 5.0.1 2 days ago
requirements.txt Bump flask-babel from 2.0.0 to 3.0.0 1 week ago
setup.py [mod] replace /help by /info pages and include pages in project docs 11 months ago

README.rst

.. SPDX-License-Identifier: AGPL-3.0-or-later

----

.. figure:: https://raw.githubusercontent.com/searxng/searxng/master/src/brand/searxng.svg
:target: https://docs.searxng.org/
:alt: SearXNG
:width: 100%
:align: center

----

Privacy-respecting, hackable `metasearch engine`_

If you are looking for running instances, ready to use, then visit searx.space_.
Otherwise jump to the user_, admin_ and developer_ handbooks you will find on
our homepage_.

|SearXNG install|
|SearXNG homepage|
|SearXNG wiki|
|AGPL License|
|Issues|
|commits|
|weblate|
|SearXNG logo|

----

.. _searx.space: https://searx.space
.. _user: https://docs.searxng.org/user
.. _admin: https://docs.searxng.org/admin
.. _developer: https://docs.searxng.org/dev
.. _homepage: https://docs.searxng.org/
.. _metasearch engine: https://en.wikipedia.org/wiki/Metasearch_engine

.. |SearXNG logo| image:: https://raw.githubusercontent.com/searxng/searxng/master/src/brand/searxng-wordmark.svg
:target: https://docs.searxng.org/
:width: 5%

.. |SearXNG install| image:: https://img.shields.io/badge/-install-blue
:target: https://docs.searxng.org/admin/installation.html

.. |SearXNG homepage| image:: https://img.shields.io/badge/-homepage-blue
:target: https://docs.searxng.org/

.. |SearXNG wiki| image:: https://img.shields.io/badge/-wiki-blue
:target: https://github.com/searxng/searxng/wiki

.. |AGPL License| image:: https://img.shields.io/badge/license-AGPL-blue.svg
:target: https://github.com/searxng/searxng/blob/master/LICENSE

.. |Issues| image:: https://img.shields.io/github/issues/searxng/searxng?color=yellow&label=issues
:target: https://github.com/searxng/searxng/issues

.. |PR| image:: https://img.shields.io/github/issues-pr-raw/searxng/searxng?color=yellow&label=PR
:target: https://github.com/searxng/searxng/pulls

.. |commits| image:: https://img.shields.io/github/commit-activity/y/searxng/searxng?color=yellow&label=commits
:target: https://github.com/searxng/searxng/commits/master

.. |weblate| image:: https://translate.codeberg.org/widgets/searxng/-/searxng/svg-badge.svg
:target: https://translate.codeberg.org/projects/searxng/


Contact
=======

Come join us if you have questions or just want to chat about SearXNG.

Matrix
`#searxng:matrix.org `_

IRC
`#searxng on libera.chat `_
which is bridged to Matrix.


Differences to searx
====================

SearXNG is a fork of `searx`_. Here are some of the changes:

.. _searx: https://github.com/searx/searx


User experience
---------------

- Huge update of the simple theme:

* usable on desktop, tablet and mobile
* light and dark versions (you can choose in the preferences)
* support right-to-left languages
* `see the screenshots `_

- the translations are up to date, you can contribute on `Weblate`_
- the preferences page has been updated:

* you can see which engines are reliable or not
* engines are grouped inside each tab
* each engine has a description

- thanks to the anonymous metrics, it is easier to report a bug of an engine and
thus engines get fixed more quickly

- if you don't want any metrics to be recorded, you can `disable them on the server
`_

- administrator can `block and/or replace the URLs in the search results
`_


Setup
-----

- you don't need `Morty`_ to proxy the images even on a public instance
- you don't need `Filtron`_ to block bots, we implemented the builtin `limiter`_
- you get a well maintained `Docker image`_, now also built for ARM64 and ARM/v7 architectures
- alternatively we have up to date installation scripts

.. _Docker image: https://github.com/searxng/searxng-docker


Contributing is easier
----------------------

- readable debug log
- contributions to the themes are made easier, check out our `Development
Quickstart`_ guide
- a lot of code cleanup and bug fixes
- the dependencies are up to date

.. _Morty: https://github.com/asciimoo/morty
.. _Filtron: https://github.com/searxng/filtron
.. _limiter: https://docs.searxng.org/src/searx.plugins.limiter.html
.. _Weblate: https://translate.codeberg.org/projects/searxng/searxng/
.. _Development Quickstart: https://docs.searxng.org/dev/quickstart.html


Translations
============

We need translators, suggestions are welcome at
https://translate.codeberg.org/projects/searxng/searxng/

.. figure:: https://translate.codeberg.org/widgets/searxng/-/multi-auto.svg
:target: https://translate.codeberg.org/projects/searxng/


Make a donation
===============

You can support the SearXNG project by clicking on the donation page:
https://docs.searxng.org/donate.html