FinanceHarness

https://github.com/yijia-xiao/financeharness
Admin
FinanceHarness is an autonomous financial deep research framework that plans, gathers evidence from...
Tokens:14,544
Snippets:111
Trust Score:8.3
License:Apache-2.0
Update:4 days ago
Show doc for...
Tokens:
Raw
### Install uv

Source: https://github.com/yijia-xiao/financeharness/blob/main/README.md

Install the uv package manager required for FinanceHarness.

```bash
curl -LsSf https://astral.sh/uv/install.sh | sh
```

--------------------------------

### Install FinanceHarness

Source: https://github.com/yijia-xiao/financeharness/blob/main/README.md

Clone the repository and install the financeharness command using uv.

```bash
git clone https://github.com/Yijia-Xiao/FinanceHarness.git
cd FinanceHarness
uv tool install .  # installs the `financeharness` command (alias `fh`)
```

--------------------------------

### Start HTTP+SSE service

Source: https://github.com/yijia-xiao/financeharness/blob/main/README.md

Run the HTTP+SSE service locally on 127.0.0.1:8080 using the CLI.

```bash
fh serve  # HTTP+SSE on 127.0.0.1:8080
```

--------------------------------

### Configure Backbone Environment Variables

Source: https://github.com/yijia-xiao/financeharness/blob/main/README.md

Set environment variables for API keys or local vLLM stacks to configure the backbone.

```bash
export GEMINI_API_KEY=...  # makes the Google/Gemini backbone available
export OPENAI_API_KEY=...  # makes the OpenAI/GPT backbone available

# Or point at an OpenAI-compatible vLLM stack you serve yourself:
export FH_QWEN_BASE_URL=http://gpu-box:8000/v1
export FH_QWEN_READER_BASE_URL=http://gpu-box:8001/v1   # the long-document reader
```

--------------------------------

### Run FinanceHarness Commands

Source: https://github.com/yijia-xiao/financeharness/blob/main/README.md

Execute research tasks using the fh command with various options for profiles, modes, and output saving.

```bash
fh -p "Estimate NVDA's intrinsic value with a DCF."
fh -p "Apple's competitive position in 2026?" --mode research
fh -p "..." --profile gpt --save run.json  # switch backbone; persist trajectory
echo "What's AAPL's P/E?" | fh -p          # question piped via stdin
fh --list                                  # backbones + skills; confirms the install
```

--------------------------------

### Cite FinanceHarness

Source: https://github.com/yijia-xiao/financeharness/blob/main/README.md

BibTeX entry for citing the FinanceHarness autonomous financial deep research framework.

```bibtex
@misc{xiao2026financeharnessautonomousfinancialdeep,
      title={FinanceHarness: Autonomous Financial Deep Research Framework}, 
      author={Yijia Xiao and Rujun Han and Yanfei Chen and Zifeng Wang and Ke Jiang and Zhongying CuiZhu and Vishy Tirumalashetty and Wei Wang and Burak Gokturk and Tomas Pfister and Chen-Yu Lee},
      year={2026},
      eprint={2607.27853},
      archivePrefix={arXiv},
      primaryClass={cs.CL},
      url={https://arxiv.org/abs/2607.27853}, 
}
```
Tokens:
Raw