simplexng 0.1.0

Package of SearXNG for easy local usage

SimpleXNG

SimpleXNG is a simplified package of SearXNG to make it a single command to run for local use.

The official install options for SearXNG are a bit complex and assume admin privileges to set up. This can be simplified a lot if you're just wanting to run it locally for your own use.

SimpleXNG is a tiny package to run SearXNG locally on macOS, Linux, or Windows:

• It uses uv to manage the Python dependencies.

• It omits Apache, Nginx, and Docker setup.

• It by default uses the minimal template settings with Redis and rate limiting turned off. (You can adjust the settings file if desired.)

• It publishes a package to PyPI that you can use.

I wrote this since a friend was asking me why it wasn't easier to set up for "localhost" use or embedded use. So I thought I'd see if it worked as a minimal, modern uv package.

Running

Install uv if you haven't already.

To install:

uv tool install simplexng

To run:

simplexng --open

More options:

simplexng --help

On first run, it sets up a minimal config file (on macOS and Linux it will be ~/.config/simplexng/settings.yml), which you can edit and will be used on subsequent runs.

---

Project Docs

For how to install uv and Python, see installation.md.

For development workflows, see development.md.

For instructions on publishing to PyPI, see publishing.md.

---

This project was built from simple-modern-uv.