Search hidden services on the Tor network.

Navigation

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for rly0nheart from gravatar.com rly0nheart

Unverified details

These details have not been verified by PyPI
Meta
Classifiers
Report project as malware

Project description

PyAhmia Logo

PyAhmia uses Ahmia.fi to search for hidden services on the Tor network
that match with a specified query, without an explicit requirement for Tor.

PyPI - Version PyPI - Downloads Code Size Release Date Build Status License

Features

  • Search Ahmia.fi from the command line
  • Export results to CSV
  • Enable/Disable routing requests through Tor
  • Return results in a clean readable format

Installation

PyAhmia is available on PyPI and can be installed like so:

pip install pyahmia

This will install ahmia and pyahmia as commands.

Usage

To start searching, you can call ahmia (or pyahmia) with the specified search query.

example:

ahmia QUERY

Routing Traffic Through Tor (Optional)

PyAhmia works without Tor, but you can enable routing traffic through Tor if you want.

When this is enabled, it will use Ahmia's darknet url instead of the clearnet variant.

To enable routing through Tor, you can call ahmia with the -t, --use-tor flag. This assumes the tor service is running in the background, otherwise, the command will fail before you can say "hidden wiki".

If Tor is not installed, you can check out the installation scripts located in pyahmia/scripts.

example:

ahmia QUERY --use-tor

Exporting Output

PyAhmia only supports exporting data to csv files (for now), and in order to export, you'll need to specify the -e, --export flag. This will export your search results to a file named after your search query.

example:

ahmia QUERY --export

Filtering Results by Time Period

Results can be filtered by 3 time periods (day, week, month). By default, results will be taken from all time periods ( all). You can change this by using the -p, --period option, and pass the time period you want to get results from.

example:

ahmia QUERY --period week

In Conclusion

Don't send too many requests with pyahmia. Be nice to the owners of Ahmia.fi :)

Contributing

Contributions are welcome! If you’d like to improve PyAhmia, fix a bug, or add a feature:

  1. Fork the repository
  2. Create a new branch for your changes
  3. Commit and push your changes
  4. Open a pull request

Please keep PRs focused and provide a clear description of the problem being solved. Bug reports and feature requests are also appreciated, just open an issue.

License

This project is licensed under the MIT License, see the LICENSE file for details.

[!Note] PyAhmia is not in any way affiliated with Ahmia.fi,

Project details

Verified details

These details have been verified by PyPI
Project links
GitHub Statistics
Maintainers
Avatar for rly0nheart from gravatar.com rly0nheart

Unverified details

These details have not been verified by PyPI
Meta
Classifiers

Release history Release notifications | RSS feed

This version

0.7.2

0.7.1

0.7.0

0.6.1

0.6.0

0.5.1

0.5.0

0.4.0

0.3.1

0.3.0

0.2.0

0.1.2

0.1.1

0.1.0

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyahmia-0.7.2.tar.gz (6.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pyahmia-0.7.2-py3-none-any.whl (7.8 kB view details)

Uploaded Python 3

File details

Details for the file pyahmia-0.7.2.tar.gz.

File metadata

  • Download URL: pyahmia-0.7.2.tar.gz
  • Upload date:
  • Size: 6.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for pyahmia-0.7.2.tar.gz
Algorithm Hash digest
SHA256 848d4b364d2c56fc0d2f36d2a487022b7862ebcec7d6abf2c86b7835327b0772
MD5 b1150e3083c23d4017254bb9c8ac70fb
BLAKE2b-256 66efda2ba30172b366500a2d0b40a61b2fca2e1c06d63859bc454bdc69feb80a

See more details on using hashes here.

Provenance

The following attestation bundles were made for pyahmia-0.7.2.tar.gz:

Publisher: python-publish.yml on escrapism/pyahmia

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pyahmia-0.7.2-py3-none-any.whl.

File metadata

  • Download URL: pyahmia-0.7.2-py3-none-any.whl
  • Upload date:
  • Size: 7.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for pyahmia-0.7.2-py3-none-any.whl
Algorithm Hash digest
SHA256 7f39d9722637064aee40cf817866d1d63a8f39d56b0b3e90f7fa1df81e6b7c0f
MD5 8e269d2a7dcad95088cc22dff390effe
BLAKE2b-256 85b42bf0192f485aa1f053d4daa35f5cd49b4dc9a2a86c0965ab8684172f9cfc

See more details on using hashes here.

Provenance

The following attestation bundles were made for pyahmia-0.7.2-py3-none-any.whl:

Publisher: python-publish.yml on escrapism/pyahmia

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page