Metadata-Version: 2.4
Name: pyahmia
Version: 0.1.2
Summary: Search hidden services on the Tor network.
License-Expression: MIT
License-File: LICENSE
Author: Escrapism
Author-email: escrapism@duck.com
Requires-Python: >=3.11,<4.0
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Requires-Dist: BeautifulSoup4 (>=4.13.4,<5.0.0)
Requires-Dist: requests-tor (>=1.4,<2.0)
Requires-Dist: rich-click (>=1.8.9,<2.0.0)
Requires-Dist: update-checker (>=0.18.0,<0.19.0)
Project-URL: issues, https://github.com/escrapism/pyahmia/issues
Project-URL: repository, https://github.com/escrapism/pyahmia
Description-Content-Type: text/markdown

**PyAhmia** uses Ahmia.fi to search for hidden services on the Tor network
that match with a specified query, it works as a command-line interface tool and provides an easier way to export output
to a csv file.

![example](https://raw.githubusercontent.com/escrapism/pyahmia/refs/heads/master/img/example.gif)

## Features

- Search Ahmia.fi from the command line
- Export results to CSV
- Route requests through Tor
- Limit or expand result count

## Installation

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

```commandline
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:

```commandline
ahmia QUERY
```

### 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. E.g.,:

```commandline
ahmia QUERY --export
```

### Routing through Tor

PyAhmia supports routing traffic through Tor. 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 `--use-tor` flag.
This assumes the tor service is running in the background, otherwise, the command will fail before you can say "hidden
wiki". E.g.,:

```commandline
ahmia QUERY --use-tor
```

### Limiting output

By default, pyahmia prints 20 results, but will also show the total amount of results that
were found for the specified query. You can change this by using the `-l, --limit` option and pass a number for how many
results you want to print. E.g.,:

```commandline
ahmia QUERY --limit 50
```

> [!Note]
> If the total number of results found is equal to the specified limit or more than that, then you'll see exactly that
> many.

## 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:

* Fork the repository
* Create a new branch for your changes
* Commit and push your changes
* 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](https://github.com/escrapism/pyahmia/blob/master/LICENSE) file for details.


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