Skip to content
/ nyja Public

Nyja is a modular toolkit designed to help researchers study the Tor network.

License

Notifications You must be signed in to change notification settings

B611/nyja

Repository files navigation

Nyja, the Dark Web sensing toolkit

Nyja is a modular toolkit designed to help researchers study the Tor network.

It is a cross-platform and user-friendly toolkit that allows researchers to conduct massive metadata gathering, timestamp-based archiving of websites, scheduled monitoring of indexing websites for automatic discovery of .onion links, and much more.

In order to run nyja, the only required dependency is having Docker installed and running. You can install Docker Desktop by following this link.


GUI Demo

Kent_PR_nyja_WI_video.mov

CLI Demo

nyja_CLI


Running the GUI

The Web Application is designed to use nyja through an easy to use interface via your web browser.

Running the script in the launchers folder will start the project, create a node on the Tor network, and start services such as MongoDB.

If you want to run the Web Application on GNU/Linux :

$ ./launchers/unix/run_web.sh

Or on Windows :


$ ./launchers/windows/run_web.bat

It will then open a nyja GUI in your default web browser.

Running the CLI

The CLI is a fish command-line interface with autocomplete allowing to quickly interact with nyja for advanced users.

Running the script in the launchers folder will start the project, create a node on the Tor network, and start services such as MongoDB.

If you want to run the CLI on GNU/Linux :

$ ./launchers/unix/run_cli.sh

Or on Windows :

$ ./launchers/windows/run_cli.bat

You will then land in a fish shell, in our custom environment. The tool can be interacted with following the help, using different commands.

For example, get the list of onion websites present on https://dark.fail and output them locally without saving in database :

$ nyja crawl "https://dark.fail" --output

Browser Compatibility

Chrome > 85 / Firefox > 77 / Safari > 13.1

Made with ❤ by Gabriel, Louis and Robin