sylva/sylva repository overview

⁠Sylva identity discovery

Note that Sylva is undergoing rapid development and documentation may be quickly obsoleted.

Visit the Sylva Wiki⁠ for more information.

⁠Summary

⁠Useful Integrations

$ : paid | T : trial | F : Free | F+ : Freemium

Most development was done without any paid access -- so despite some integrations requiring an account, the full experience can be attained without any subscriptions.

⁠GitHub Integration

Query GitHub for any known PGP keys, scrape both the oldest and newest 1000 commit authorships (2000 total) for leaked identifying information, and search for identities based on full name, email, or username.

Personal Access Token (PAT) is required for PGP scraping, but all other functions work out of the box. PAT is recommended for higher rate limits on other functions. PAT does not require any permissions assigned to it whatsoever.

⁠Native modules

⁠Helpers and utilities

⁠Usage

sylva search <query> will search all available modules for the given query.

sylva branch <query> will search all available modules for the given query, merge and deduplicate results, and resume searching with the newly found identities up to a certain depth. Some modules, particularly those with low API limits, may be branch disabled by default.

sylva config --edit to edit the configuration file (including API keys).

⁠Installation

Docker is the preferred method of installation, providing the most consistent experience.

docker run -it sylva/sylva branch <query>

Other installation methods are described on the Sylva Wiki⁠.

⁠Contributing

Contributors should refer to our contributing guidelines⁠ for information on how to contribute to the project. Note that since the project is still in its infancy, there isn't yet a formal roadmap.

Contributors opening a pull request are assumed to have read and agreed to the guidelines.