> For the complete documentation index, see [llms.txt](https://hashman.gitbook.io/hashman-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hashman.gitbook.io/hashman-docs/introduction-to-hashman.md).

# Introduction to Hashman

Hashman is the ultimate mining companion tool for managing and optimizing your bitcoin mining operations. It supports various miner firmware types and provides advanced features for automating, monitoring, controlling, and optimizing your mining operation.

## Hashman's philosophy: intelligent mining automation

Hashman approaches Bitcoin mining automation through clear separation of concerns and precise economic modeling:

### Core architecture

1. **Agent Layer** - Hardware & Location

* Manages physical ASICs in specific locations
* Handles network discovery and connectivity
* Enforces location-specific constraints
* Provides real-time monitoring and control

2. **Profile Layer** - Economic Logic

* Defines price-based operating rules
* Location-independent behavior patterns
* Calculates profitability thresholds
* Optimizes for market conditions

### Economic model

The system continuously optimizes operations by evaluating:

* Marginal electricity costs (from profile definitions)
* Current Bitcoin mining revenue
* Individual ASIC efficiency curves
* Network difficulty projections 

 **These variables create a dynamic schedule that maximizes profitability under normal conditions.**

### Grid services integration (coming soon..)

The standard economic model can be overridden by grid service commitments:

* Frequency Containment Reserve (FCR)
* Manual Frequency Restoration Reserve (mFRR)
* Demand Response programs
* Emergency grid support 

These grid services take absolute priority over regular mining operations, allowing miners to participate in critical power grid stability functions while maintaining profitable operations during normal conditions.\ <br>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://hashman.gitbook.io/hashman-docs/introduction-to-hashman.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.