Installation and first run • Usage • Authors • Credits • License
This guide assumes you are running Arch linux or a similar OS, although any docker-compose capable X86 system should be able to run it. No guarantees though Clone this github repo:
$ git clone https://github.com/Knox-AAU/FunctionalityLayer_SemanticSearchEngine
Make sure docker is running. For Systemd systems:
$ systemctl start docker
Change to the docker directory:
$ cd docker
Run docker-compose:
$ docker-compose up -d
Note: This WILL take a while the first time.
Note2: This command will not respect any changes to the files after it has been run once, to rebuild with any changes add the --build
flag to the command
When the previous command has finished executing the node container starts compiling the react web app, this will take a while and if patience is not one of your virtues: To monitor this(not necessary):
$ docker-compose up node
Note: If node finishes compiling the web app, nothing will be printed after "Attaching to semanticNode" if this is the case you can continue. If not the message: Server running at http://0.0.0.0:80/
will eventually be printed. Now the app and server is ready, continue to next step.
Note2: The terminal is now attached to the docker container and closing it or terminating the command will stop the container
You can now navigate to localhost:8080 where the webapp should be running.
If you haven't followed the instructions in Installation and first run and see the web app, DO!!!
At the very top-left a very-difficult-to-see button that says admin
on it is present. Press this and you will be redirected to the admin page.
Here you can add wikipedia links to the database(comes empty). Example of valid Wikipedia link: https://en.wikipedia.org/wiki/Barack_Obama
Add a couple by pasting a link into the input field and press add to DB
.
The button will disappear and if it reappears without any pop-ups(alerts) the link was added successfully, otherwise..... RIP
There is also another button: Reset
. This button, contrary to popular belief, reloads the database and re-pre-processes the entire database so it's ready for searching. Unfortunately there is no indication when this is done without having a terminal attached to the docker container "ranking"(make sure your terminal is in the docker container):
$ docker-compose up ranking
Note: The pre-processing is done when the message: INFO:shared_utils:Documents: Done Processing and ready for requests
appears
Back on the main page there are two sections: - The chatbot bar(Doesn't work) - The search bar The searchbar works as you would expect but has two search buttons - Search - No LlamaSearch The second button was added as Llama is painfully slow(5+ minutes) on the servers the original group had access to and doesn't seem to benefit the search(Based on personal experience) The advanced button does not work
Have FUN
- Node.js
- Puppeteer
- Transformers
- PyTorch
- Docker
- PostgreSQL
- React
- TypeScript
- Python
- psycopg2
- NumPy
- PG
- TailwindCSS
- Wikipedia
MIT