Home

→ pankajads.github.io/factfolio — the pitch, the diagrams, one page.

FactFolio

FactFolio is a free, open-source, locally-run advisory system for Indian equity and mutual fund portfolios. Every BUY / SELL / HOLD / TRIM call is checked against your policy, before you ever see it, and traceable back to the exact tool call that produced it. No black box, no guesswork, no fees.

This wiki is the deep-dive companion to that page. Start here, or jump straight to a topic:

• Installing — three ways to run it, from uvx to a standalone executable to cloning the repo.
• Architecture — how the seven agents and the validator gate turn holdings into a cited recommendation.
• FAQ — authentication, the "unknown publisher" warning, and other things people ask before trusting it with their portfolio.

For everything else — the full command reference, tax-impact modelling, policy file format — see docs/USER_GUIDE.md in the repository itself, which this wiki intentionally doesn't duplicate.

The shortest version

flowchart TD
    H["holdings.csv + investment_policy.md"] --> A1[market-analyst]
    H --> A2[portfolio-auditor]
    H --> A3[stock-researcher]
    H --> A4[mf-analyst]
    H --> A5[tax-strategist]
    H --> A6[risk-officer]
    A1 --> D["devil's-advocate<br/>adversarial review"]
    A2 --> D
    A3 --> D
    A4 --> D
    A5 --> D
    A6 --> D
    D --> G{"validator gate<br/>cites a real tool call?"}
    G -- yes --> R["reports/*.md"]
    G -- no --> X[rejected]

Loading

Six specialist agents analyse your portfolio in parallel. A seventh tries to tear their findings apart. A code-level gate — not another model promising to check itself — then rejects anything that cites a number not actually present in that run's tool-call log. See Architecture for the rest, including what never leaves your machine.

Three commands to try it

uvx factfolio init      # first-run setup, no install
uvx factfolio status    # instant snapshot, no LLM, no network beyond price data
uvx factfolio report    # full multi-agent review → reports/

More install options, including a standalone executable for people who'd rather not have Python involved at all, on the Installing page. Everything here is a terminal tool — no GUI, no browser — including factfolio mcp, which runs the same engine as a standalone MCP server for external clients like the VS Code Claude extension or Claude Desktop.

---

MIT licensed · not investment advice · repository · issues