💾 Archived View for gmn.clttr.info › sources › geminispace.info.git › tree › README.md.txt captured on 2023-01-29 at 05:01:30.

View Raw

More Information

➡️ Next capture (2023-04-20)

-=-=-=-=-=-=-

# Gemini Universal Search (GUS)


## Dependencies

1. Install python (>3.5) and [poetry](https://python-poetry.org)
2. Run: `poetry install`


## Making an initial index

Make sure you have some gemini URLs for testing which are nicely
sandboxed to avoid indexing huge parts of the gemini space.

1. Create a "seed-requests.txt" file with you test gemini URLs
2. Run: `poetry run crawl -d`
3. Run: `poetry run build_index -d`

Now you'll have created `index.new` directory, rename it to `index`.


## Running the frontend

1. Run: `poetry run serve`
2. Navigate your gemini client to: "gemini://localhost/"

### Running the frontend in production with systemd

1. update `infra/gus.service` to match your needs (directory, user)
2. copy `infra/gus.service` to `/etc/systemd/system/`
3. run `systemctl enable gus` and `systemctl start gus`

## Running the crawl to update the index

1. Run: `poetry run crawl`
2. Run: `poetry run build_index`
3. Restart frontend

### Running the crawl & indexer in production with systemd

3. set up a cron job with the following params: `0 9 * * * /home/gus/infra/update-index.sh /home/gus` 

## Running the test suite

Run: `poetry run pytest`