# OpenCandle

> OpenCandle is an open source financial investigator for evidence-first market research in a terminal agent or local browser GUI.

Last updated: 2026-06-01
Website: https://opencandle.app
Repository: https://github.com/Kahtaf/OpenCandle
Package: https://www.npmjs.com/package/opencandle

## Quick start

```bash
npx opencandle@latest
npx opencandle@latest gui
```

## Summary

OpenCandle gathers quotes, price history, options chains, SEC filings, macro series, sentiment, fundamentals, crypto data, and local portfolio context before synthesis. It is read-only research software: it does not place trades, route orders, or provide financial advice.

## Key pages

- [OpenCandle Docs](https://opencandle.app/docs/index.html): Documentation for the open source financial investigator.
- [Getting Started](https://opencandle.app/docs/getting-started.html): Install OpenCandle, configure providers, and run the CLI or GUI.
- [First Run](https://opencandle.app/docs/first-run.html): Get from a fresh OpenCandle install to a successful first market answer in about five minutes.
- [TUI](https://opencandle.app/docs/tui.html): Use the OpenCandle terminal interface, slash commands, sessions, and the local GUI together.
- [Investigation Recipes](https://opencandle.app/docs/investigation-recipes.html): Repeatable OpenCandle research paths for market, macro, filings, sentiment, and portfolio work.
- [Data Sources](https://opencandle.app/docs/data-sources.html): Provider coverage, credentials, and data boundaries in OpenCandle.
- [Configuration](https://opencandle.app/docs/configuration.html): Environment variables, file config, state paths, and GUI runtime settings.
- [GUI Quickstart](https://opencandle.app/docs/gui-quickstart.html): Run the local OpenCandle browser workbench and understand writer/follower behavior.
- [System Architecture](https://opencandle.app/docs/system-architecture.html): How OpenCandle turns a financial question into evidence, tool output, and an answer.
- [Build a Tool](https://opencandle.app/docs/build-a-tool.html): Add first-party OpenCandle tools or publish Pi-compatible finance tool packages.
- [Testing and Evals](https://opencandle.app/docs/testing-and-evals.html): How OpenCandle validates tools, workflows, GUI behavior, and full agent runs.
- [Benchmarking](https://opencandle.app/docs/benchmarking.html): How OpenCandle compares full finance-agent behavior against generic agents.
- [Comparisons](https://opencandle.app/docs/comparisons.html): Compare OpenCandle with general chatbots, spreadsheets, finance websites, and custom scripts.
- [OpenCandle vs ChatGPT](https://opencandle.app/docs/opencandle-vs-chatgpt.html): Compare OpenCandle with ChatGPT for evidence-first financial research workflows.
- [OpenCandle vs Spreadsheets](https://opencandle.app/docs/opencandle-vs-spreadsheets.html): Compare OpenCandle with spreadsheets for financial research, portfolio context, and evidence gathering.
- [Contributing to OpenCandle](https://opencandle.app/docs/contributing.html): OpenCandle documentation.
- [Security Policy](https://opencandle.app/docs/security.html): OpenCandle documentation.

## AI-readable files

- [Full markdown context](https://opencandle.app/llms-full.txt)
- [Project agent instructions](https://opencandle.app/AGENTS.md)