Metadata-Version: 2.4
Name: stashhouse
Version: 0.0.2
Summary: Centrally store files from a variety of protocols.
Project-URL: Homepage, https://github.com/Jayson-Fong/stashhouse
Project-URL: Issues, https://github.com/Jayson-Fong/stashhouse/issues
Author-email: Jayson Fong <jayson.fong@gatech.edu>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 1 - Planning
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Provides-Extra: ssh
Requires-Dist: stashhouse-ssh>=0.0.1; extra == 'ssh'
Description-Content-Type: text/markdown

<div align="center">
   <h1>🏠 StashHouse</h1>
</div>

<hr />

<div align="center">

[💼 Purpose](#purpose) | [🏁 Usage](#usage)

</div>

<hr />

# Purpose

StashHouse is a framework for centrally collecting files to enable rapid file transfers. The framework is designed with
a plugin system to enable the inclusion of additional file transfer protocols while working to minimize the overhead
required for file transfers.

### Use Cases

<details style="border: 1px solid; border-radius: 8px; padding: 8px; margin-top: 4px;">
<summary>🔬Data Donation</summary>

Accept data from a population while prohibiting parties from accessing each other's data.

</details>

<details style="border: 1px solid; border-radius: 8px; padding: 8px; margin-top: 4px;">
<summary>📦 Bulk Data Collection</summary>

Acquire system data from internet of thing devices and scripts without requiring authentication tokens while preventing 
data exfiltration.

</details>

<details style="border: 1px solid; border-radius: 8px; padding: 8px; margin-top: 4px;">
<summary>🪂 Malware Analysis</summary>

Allow customers to drop artifacts for analysis with minimal overhead and through their preferred protocol.

</details>

# Usage

StashHouse provides a `stashhouse` command to quickly start installed plugins.

Install the `stashhouse` package:
```commandline
python3 -m pip install stashhouse
```

To see available configuration options, use the `--help` flag:
```commandline
stashhouse --help
```