// readme

Hashtopolis Agent (Rust)

A Hashtopolis agent written in Rust.

Prerequisites

  • Rust (edition 2024) and a C compiler. ring (pulled in by rustls) compiles C sources, so you need cc/clang on the build host.
  • hashcat itself is provisioned by the server, you do not install it yourself. The exception is macOS, where the official hashcat archive ships no hashcat.osx, so you point the agent at a local hashcat (see Configure).

Build

cargo build --release

The binary lands at target/release/htp-agent.

Release

A full release bundle is dist/rust-agent.zip: the three platform binaries (linux-musl, windows-msvc, macos-aarch64) plus a manifest.json and the run.sh / run.bat launchers. This is the artifact the backend serves as the rust agent type.

Via CI (the normal path). Push a v* tag:

git tag v0.1.0
git push origin v0.1.0

release.yml builds each target natively on its own runner, packages them, and attaches rust-agent.zip to the GitHub release. You can also trigger the workflow manually, which builds the zip without attaching it anywhere.

Run

./htp-agent

The agent reads two JSON files side by side:โ€ฆ