{"id":51233435,"url":"https://github.com/hoaxnerd/burnless","last_synced_at":"2026-06-28T18:01:51.979Z","repository":{"id":364806810,"uuid":"1269263114","full_name":"hoaxnerd/burnless","owner":"hoaxnerd","description":"The always-on financial companion for founders","archived":false,"fork":false,"pushed_at":"2026-06-25T07:58:23.000Z","size":6557,"stargazers_count":16,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-06-25T08:23:11.905Z","etag":null,"topics":["ai","cli","finance","financial-planning","founders","fpa","nextjs","open-source","pglite","self-hosted","startup","typescript"],"latest_commit_sha":null,"homepage":"https://burnless.ai","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hoaxnerd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":"NOTICE","maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-06-14T13:54:41.000Z","updated_at":"2026-06-23T14:05:28.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/hoaxnerd/burnless","commit_stats":null,"previous_names":["hoaxnerd/burnless"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/hoaxnerd/burnless","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hoaxnerd%2Fburnless","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hoaxnerd%2Fburnless/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hoaxnerd%2Fburnless/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hoaxnerd%2Fburnless/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hoaxnerd","download_url":"https://codeload.github.com/hoaxnerd/burnless/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hoaxnerd%2Fburnless/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34898568,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-28T02:00:05.809Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","cli","finance","financial-planning","founders","fpa","nextjs","open-source","pglite","self-hosted","startup","typescript"],"created_at":"2026-06-28T18:01:50.776Z","updated_at":"2026-06-28T18:01:51.973Z","avatar_url":"https://github.com/hoaxnerd.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n\u003ca href=\"https://burnless.ai\"\u003e\u003cimg src=\".github/assets/banner.png\" alt=\"burnless — the always-on financial companion for founders\" width=\"100%\"\u003e\u003c/a\u003e\n\n\u003cbr\u003e\n\n[![License: AGPL-3.0](https://img.shields.io/badge/license-AGPL--3.0-blue.svg)](./LICENSE)\n[![Latest release](https://img.shields.io/github/v/release/hoaxnerd/burnless?label=release)](https://github.com/hoaxnerd/burnless/releases)\n[![CI](https://img.shields.io/github/actions/workflow/status/hoaxnerd/burnless/ci.yml?label=CI)](https://github.com/hoaxnerd/burnless/actions)\n[![GitHub stars](https://img.shields.io/github/stars/hoaxnerd/burnless?style=flat)](https://github.com/hoaxnerd/burnless/stargazers)\n[![Discussions](https://img.shields.io/github/discussions/hoaxnerd/burnless)](https://github.com/hoaxnerd/burnless/discussions)\n\n\u003c!-- LAUNCH FILM: paste the link below once it's live, then uncomment.\n**[▶ Watch the 90-second launch film](VIDEO_URL)**\n--\u003e\n\n\u003c/div\u003e\n\n---\n\nThe scariest part of being a founder isn't running low on cash. It's **finding out a month after you needed to act.**\n\nYou're heads-down building a product — not wrangling a spreadsheet for answers, or coaxing a chatbot into doing the math for you. So the numbers drift, and by the time you look, the moment to course-correct has already passed.\n\n**Burnless is the always-on financial companion for founders.** It reads your real financials and watches your burn, your runway, your revenue — all of it, all the time — and surfaces what you need to know *before you have to ask. That morning, not a month later.*\n\nIt's open source, AI-native, and self-hosts in **one command** with an embedded database — no Docker, no Postgres to run. Your numbers stay on your machine; you bring your own AI.\n\n```sh\ncurl -fsSL https://burnless.ai/install | sh\n```\n\n## A look inside\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd width=\"25%\"\u003e\u003cimg src=\".github/assets/shots/01-dashboard-insights.png\" alt=\"Dashboard with AI insights\"\u003e\u003cbr\u003e\u003csub\u003e\u003cb\u003eAlways-on dashboard\u003c/b\u003e — burn, runway \u0026 revenue, watched live, with AI insights surfaced for you.\u003c/sub\u003e\u003c/td\u003e\n    \u003ctd width=\"25%\"\u003e\u003cimg src=\".github/assets/shots/02-companion-cfo.png\" alt=\"AI companion answering a what-if\"\u003e\u003cbr\u003e\u003csub\u003e\u003cb\u003eThe companion\u003c/b\u003e — ask in plain English; it answers with real, computed numbers.\u003c/sub\u003e\u003c/td\u003e\n    \u003ctd width=\"25%\"\u003e\u003cimg src=\".github/assets/shots/03-scenario-diff.png\" alt=\"Scenario diff comparing base vs scenario\"\u003e\u003cbr\u003e\u003csub\u003e\u003cb\u003eWhat-if, compared\u003c/b\u003e — every change diffed against your base case, line by line.\u003c/sub\u003e\u003c/td\u003e\n    \u003ctd width=\"25%\"\u003e\u003cimg src=\".github/assets/shots/04-scenario-overlay.png\" alt=\"Scenario overlay mode on the dashboard\"\u003e\u003cbr\u003e\u003csub\u003e\u003cb\u003eScenario mode\u003c/b\u003e — model freely as an overlay, without touching your real data.\u003c/sub\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd width=\"25%\"\u003e\u003cimg src=\".github/assets/shots/05-revenue.png\" alt=\"Revenue page with MRR and growth\"\u003e\u003cbr\u003e\u003csub\u003e\u003cb\u003eRevenue\u003c/b\u003e — MRR, streams, waterfall, and projections.\u003c/sub\u003e\u003c/td\u003e\n    \u003ctd width=\"25%\"\u003e\u003cimg src=\".github/assets/shots/06-funding.png\" alt=\"Funding page with rounds and dilution\"\u003e\u003cbr\u003e\u003csub\u003e\u003cb\u003eFunding\u003c/b\u003e — rounds, cap table, and a live dilution calculator.\u003c/sub\u003e\u003c/td\u003e\n    \u003ctd width=\"25%\"\u003e\u003cimg src=\".github/assets/shots/08-expenses.png\" alt=\"Expenses page with category breakdown\"\u003e\u003cbr\u003e\u003csub\u003e\u003cb\u003eExpenses\u003c/b\u003e — categorized spend, anomalies, and budget-vs-actuals.\u003c/sub\u003e\u003c/td\u003e\n    \u003ctd width=\"25%\"\u003e\u003cimg src=\".github/assets/shots/07-onboarding-connect-ai.png\" alt=\"Onboarding step to connect your own AI provider\"\u003e\u003cbr\u003e\u003csub\u003e\u003cb\u003eSmart onboarding\u003c/b\u003e — bring your own provider; up and running in a minute.\u003c/sub\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## Every decision is a what-if\n\nWhat if I hire? What if I raise? What if I cut? Ask in plain English and Burnless builds the scenario on your real model — then shows you the impact on runway, burn, and cash before you commit to anything.\n\nWork in **scenario mode** to explore freely: it's a non-destructive overlay on your real data, so nothing you try touches the base case. Compare scenarios side by side, then promote the one you want to baseline.\n\n## And a lot more\n\n- **AI companion** — a chat that reads your live financials and takes actions through tools (build a scenario, adjust headcount, edit a forecast line) instead of just talking about them.\n- **Forecasting** — dependency-graph forecast lines with multiple methods (fixed, growth rate, per-unit, percentage-of, custom formula), resolved in topological order.\n- **The full model** — revenue (subscription / usage / one-time / services), expenses, funding rounds with cap table, and headcount — all in one place.\n- **Reports** — P\u0026L, cash flow, balance sheet, runway, budget-vs-actuals, key metrics, and an AI-assisted board update, exportable for investors.\n- **Custom metrics \u0026 dashboard** — pin what matters, define your own metrics, lay the dashboard out your way.\n- **Automations \u0026 MCP** — schedule recurring AI runs, connect external tools over MCP, and expose Burnless itself as an MCP server other agents can drive.\n- **Bring any AI** — a provider-agnostic layer works with Anthropic, OpenAI, OpenRouter, or fully local with Ollama.\n\n## Computed, not hallucinated\n\nThe math is not the AI's guess. A deterministic, Decimal-precision financial engine and a traceable forecast dependency graph do every calculation; the AI *operates* that engine through tools. So when Burnless tells you your runway, it's a number you can trace — not a number a model made up.\n\n## Quickstart\n\nInstall with the shell one-liner:\n\n```sh\ncurl -fsSL https://burnless.ai/install | sh\n```\n\nOr with npm:\n\n```sh\nnpm install -g burnless\n# or run without installing:\nnpx burnless start\n```\n\nThen start your instance:\n\n```sh\nburnless start\n```\n\nThis opens Burnless on `http://127.0.0.1:2876` (port 2876 = **BURN**) with auto-login on the loopback interface, and drops you into the onboarding wizard. One command and you're in.\n\n**Requirements:** Node **≥ 20.9**. Don't have it (or the right version)? Pass `--with-node` and the installer provisions a pinned Node for you:\n\n```sh\ncurl -fsSL https://burnless.ai/install | sh -s -- --with-node\n```\n\n\u003e Prefer to read it first? `curl -fsSL https://burnless.ai/install | less`, then run it.\n\n## Own your numbers\n\nYour financial model is some of the most sensitive data your company has. Burnless is built so it never has to leave your control:\n\n- **Nothing phones home.** Self-hosted, your financials and your AI keys stay on your infrastructure.\n- **Your data, your AI, your choice.** Point it at any provider — or run a local model with Ollama — and own the whole stack.\n- **Open forever.** The AGPL license keeps improvements open: anyone who ships a modified Burnless shares those changes back. It's honest, not bait-and-switch.\n- **It can't be taken away.** Founder finance tools have a habit of getting acquired and shut down. An open-source one you run yourself can't be — the code is yours to keep, run, and reshape.\n\nA managed **cloud** edition — the same codebase with the operational pieces handled for you — is on the way for teams that would rather not run it themselves. The core stays open either way.\n\n## Self-host\n\nThe self-host story is the whole point: **a single artifact with an embedded database — no Docker, no Postgres to run.**\n\n```sh\ncurl -fsSL https://burnless.ai/install | sh   # or: npm install -g burnless\nburnless start\n```\n\n- **Requirements:** Node ≥ 20.9 (or pass `--with-node` to provision a pinned Node).\n- **Your data** lives under `~/.burnless/data`. Back it up by copying that directory — it sits outside the versioned install, so it survives updates and rollbacks.\n- **Updates are atomic:** `burnless update` swaps in the new version and runs a health check; if it fails to come up, it automatically rolls back to the prior one. Your data is never touched.\n- **Loopback by default:** Burnless binds to `127.0.0.1` — that's what makes auto-login safe, since the loopback interface is the security boundary. Exposing it more widely is an explicit, opt-in step.\n\n| | Self-host | Cloud *(coming)* |\n|---|---|---|\n| Who runs it | You | Managed for you |\n| AI | Bring your own provider / key | Hosted AI included |\n| Data | On your machine (`~/.burnless/data`) | Hosted |\n| Ops | One command | Zero-ops |\n| Cost | Free, forever | Managed plans |\n\n## How it works\n\nBurnless is a pnpm + turbo monorepo. Data flows from the database through the financial engine and AI layer into a Next.js app:\n\n```\n                          ┌──────────────────────────┐\n   apps/web  ────────────▶│  Next.js app + API +     │\n   (dashboard, API,       │  the dashboard UI        │\n    middleware)           └────────────┬─────────────┘\n                                        │\n        ┌───────────────────────────────┼───────────────────────────────┐\n        ▼                                ▼                                ▼\n packages/engine               packages/ai                       packages/db\n pure-TS financial calc        provider-agnostic LLM layer        Drizzle ORM\n (Decimal precision)           (Anthropic/OpenAI/                 PGlite local /\n                                OpenRouter/Ollama)                 Postgres cloud\n\n   packages/cli  →  the `burnless` CLI (start / update / mcp serve / …)\n   packages/mcp  →  Model Context Protocol support (consume + expose)\n   packages/types, packages/ui  →  shared TS types + React components\n```\n\n- **`apps/web`** — the Next.js app: dashboard, API routes, and middleware.\n- **`packages/engine`** — pure-TypeScript financial calculations with Decimal.js precision (no I/O, no DB).\n- **`packages/ai`** — the provider-agnostic LLM layer and chat/tool loop.\n- **`packages/db`** — Drizzle ORM schema and queries; PGlite when self-hosted, Postgres for cloud and scale.\n- **`packages/cli`** — the `burnless` CLI that installs, starts, updates, and manages your instance.\n- **`packages/mcp`** — Model Context Protocol support: connect external MCP tools and expose Burnless as an MCP server.\n- **`packages/types` / `packages/ui`** — shared TypeScript types and React components.\n\n## Documentation\n\nStart with [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup and conventions. More documentation is on the way as the project matures.\n\n## Community \u0026 support\n\n- **Questions, ideas, show-and-tell:** [GitHub Discussions](https://github.com/hoaxnerd/burnless/discussions)\n- **Bugs \u0026 feature requests:** [GitHub Issues](https://github.com/hoaxnerd/burnless/issues)\n\u003c!-- FOLLOW: add your X/Twitter handle here once the launch is posted, e.g.\n- **Building in public:** follow along [@handle](https://x.com/handle)\n--\u003e\n\n## Contributing\n\nContributions are welcome. Read [CONTRIBUTING.md](./CONTRIBUTING.md) to get a local instance running and learn the conventions. On your first pull request, the CLA Assistant bot will ask you to sign a one-time Contributor License Agreement — a low-friction, automated step that takes a moment.\n\n## Security\n\nFound a vulnerability? Please report it privately — see [SECURITY.md](./SECURITY.md).\n\n## License\n\nBurnless is split so it's open where it matters and embeddable where it helps you:\n\n- The server and the `@burnless/*` packages are **AGPL-3.0** ([LICENSE](./LICENSE)) — improvements stay open.\n- The **`burnless` CLI is Apache-2.0** ([packages/cli/LICENSE](./packages/cli/LICENSE)) — so you can embed and script it freely.\n\nA Contributor License Agreement exists for one reason: it lets us offer a commercial / hosted edition that funds continued development. It does not take away your rights to your own contribution — you keep them.\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Happy building.**\n\n\u003csub\u003eBurnless is an independent open-source project and is not affiliated with or endorsed by any third-party provider or trademark referenced above.\u003c/sub\u003e\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhoaxnerd%2Fburnless","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhoaxnerd%2Fburnless","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhoaxnerd%2Fburnless/lists"}