git.iko.soy/searx
on 8433421 help sign in
searx/README.md
42 lines 1.4 kB history raw
1searx
2=====
4A privacy-respecting, hackable [metasearch engine](https://en.wikipedia.org/wiki/Metasearch_engine).
6List of [running instances](https://github.com/asciimoo/searx/wiki/Searx-instances).
8[![Flattr searx](http://api.flattr.com/button/flattr-badge-large.png)](https://flattr.com/submit/auto?user_id=asciimoo&url=https://github.com/asciimoo/searx&title=searx&language=&tags=github&category=software)
10### Features
12* Tracking free
13* Modular (see [examples](https://github.com/asciimoo/searx/blob/master/examples))
14* Parallel queries
15* Supports json output `curl https://searx.0x2a.tk/?format=json&q=[query]`
16* Supports csv output `curl https://searx.0x2a.tk/?format=csv&q=[query]`
17* Opensearch support (you can set as default search engine)
18* Configurable search engines/categories
19* User-agent forwarding
21### Installation
23* clone source: `git clone git@github.com:asciimoo/searx.git && cd searx`
24* install dependencies: `pip install -r requirements.txt`
25* edit your [searx/settings.py](https://github.com/asciimoo/searx/blob/master/searx/settings.py) (set your `secret_key`!)
26* rename `engines.cfg_sample` to `engines.cfg`
27* run `python searx/webapp.py` to start the application
29### TODO
31* Moar engines
32* Better ui
33* Language support
34* Documentation
35* Pagination
36* Tests
39### Bugs
41Bugs or suggestions? Visit the [issue tracker](https://github.com/asciimoo/searx/issues).