A news reader for the stocks you hold: daily prices, headlines, and a short brief per stock written by Claude, citing its sources. Not investment advice.
- Portfolio: add holdings by search, or import a broker export as CSV by ISIN, with a dry run and a report per row.
- Prices: daily closes from Yahoo Finance and FX rates, so the overview values every holding and totals them in one base currency.
- News: the last day's headlines of each stock from Google News, with junk pages, off-topic items and duplicates dropped.
- Briefs: a few sentences per stock on what was reported, with a tone and the headlines it cites, written by Claude and checked in code.
flowchart LR
browser([Browser]) --> web[Next.js web app]
web -->|"HTTP /api/v1, from the server only"| api[FastAPI API]
subgraph jobs [Jobs, run with just]
prices[update-prices]
ingest[ingest-news]
briefs[brief]
end
subgraph providers [External services]
yahoo[Yahoo Finance]
openfigi[OpenFIGI]
gnews[Google News RSS]
llm[Anthropic API or claude CLI]
end
api --> db[(Postgres)]
prices --> db
ingest --> db
briefs --> db
api -->|search, listings| yahoo
api -->|share classes, ISINs| openfigi
prices -->|daily bars, FX rates| yahoo
ingest -->|headlines| gnews
briefs -->|briefs| llm
The browser only talks to the web app; the web app's server calls the API, whose OpenAPI schema generates the web app's types. Prices, news and briefs are written by commands run by hand, not by the API.
| Part | Built with |
|---|---|
Web (apps/web/) |
Next.js (App Router), React, TypeScript (strict), Tailwind CSS, Zod, openapi-fetch, Recharts, Biome, Vitest, pnpm |
API (apps/api/) |
Python 3.13, FastAPI, Pydantic, SQLAlchemy 2 (async, asyncpg), Alembic, structlog, ruff, pyright (strict), pytest, uv |
| Database | Postgres 18 with pg_trgm, in Docker Compose |
| Data sources | Yahoo Finance (yfinance), OpenFIGI, Google News RSS, Claude through the Anthropic API or the claude CLI |
| Tooling | just, lefthook, GitHub Actions |
The portfolio total, the unrealised gain, and the latest brief of each stock with the headlines it cites.
Every position valued in the base currency, with its average price, latest close, unrealised gain and weight.
The price history over 1 month to 5 years, your position, and the latest brief with its sources.
Search the catalogue, and fall back to the market data provider for securities not added yet.
Import a broker export as CSV by ISIN, with a preview before anything is saved.
Needs uv, pnpm, Node 22, just and Docker.
git clone https://github.com/romancxx/baseline.git && cd baseline
cp apps/api/.env.example apps/api/.env
# In apps/api/.env: set JWT_SECRET to the output of `openssl rand -hex 32`, and either
# ANTHROPIC_API_KEY, or LLM_BACKEND=cli with the `claude` CLI logged in.
cp apps/web/.env.example apps/web/.env.local
just api-install
pnpm --dir apps/web install
just hooks-install
just devjust dev starts Postgres, applies the migrations, and serves the API on http://localhost:8000 and the web app on http://localhost:3000.
Create an account, add or import holdings, then fill in their data from a second terminal:
just update-prices # daily prices and FX rates
just ingest-news # the last day's headlines
just brief # a brief per stock with new headlinesjust alone lists every command.
| Path | Contents |
|---|---|
apps/api/ |
The backend: endpoints, jobs, settings and migrations; its code standards and decision records |
apps/web/ |
The frontend: its code standards and decision records |
GLOSSARY.md |
The domain vocabulary both apps share |
justfile |
Every command, run from the repository root |
docker-compose.yml |
The API's Postgres |
Each source's terms, and what Baseline does with its data, are in the API's README.
MIT, see LICENSE.




