greeksoup/ docs
Documentation

GreekSoup documentation

The one-person equity research desk that runs on your own computer, written up for a reader who has never seen it. For investors who refuse to settle.

Get startedWhat the desk is, the three ways in, and what the first ten minutes look like.Start here InstallOne line on a Mac, Windows or Linux; with an AI agent; from source. Keeping it running, updating, backing up.Install it BrokersSixteen connect as the desk comes, read-only. Where each one's keys come from and what each one shows.Connect yours MarketsThe market follows the broker: hours, the index, the currency, the results calendar, the filings.Your market

What GreekSoup is

A research desk that runs as a small program on your own computer and opens in your browser. Sixteen screens: your positions, the filings, the 13F and insider trades, the options tape, short interest, macro, a commodity board that names the industries each move squeezes or helps, your own value chains, a research vault of plain files, and a page for any ticker, priced live. It reads the public record (SEC EDGAR, CBOE, FINRA, FRED, Yahoo), your broker if you connect one, and one optional data feed. Every list a screen runs on is yours, and an AI you already pay for answers about your book without a key.

Three things are involved, and it helps to know which is which.

The desk is the program in the folder you download. While it runs, it shows its screens at an address in your browser. It stores everything on your computer and keeps running whether or not anything else is open.

The agent is the AI coding tool you type to, if you have one. It installs the desk, connects your broker, and changes the desk when you ask for something new. You do not need it open to use the desk day to day, and you do not need it at all for the one-line install.

The data comes from three places. Your broker knows what you own. The public record is free and needs no account. An optional paid feed adds the parsed financial statements on the ticker page and a few columns. Skip the feed and nothing breaks.

The three rules the desk is built on

Nothing on it places an order. Nothing in it assumes your broker, your country or your data provider; you pick each one from a list, or leave it empty, and the desk gives you the most it can from what you gave it. And what ships is a starter, never your list: every list a screen runs on is yours to change from the screen, and an update never loses what you saved. It answers only to your own computer, and Security says exactly what that means.

Where to go next