robosystems-xbrl-holon 0.1.2

CLI that converts SEC XBRL filings into holon.jsonld documents

RoboSystems XBRL Holon

Convert SEC XBRL filings into holon.jsonld documents that render in the RoboSystems Holon Viewer.

Install

As a package

pip install robosystems-xbrl-holon

Exposes the holon CLI (holon build …, holon fetch …, holon query …) and the library — use this to consume it from another project. Set your SEC User-Agent via the environment (see SEC User-Agent).

From source (development)

# Install the toolchain
brew install uv just

# Install dependencies and provision .env from the template
just install

just install creates .env from .env.example on first run — then set your SEC User-Agent in it.

SEC User-Agent

SEC EDGAR requires a descriptive User-Agent on every request, or it throttles you (empty responses / HTTP 429). just install already created your .env — set your details there:

# .env
SEC_GOV_USER_AGENT="Your Name [e-mail]"

.env is loaded automatically by every command. Outside the just workflow, export SEC_GOV_USER_AGENT="Your Name [e-mail]" or pass --user-agent.

Usage

# Build a holon.jsonld from a specific filing (-> ./output/)
holon build --cik 320193 --accno 0000320193-23-000106

# Fetch the latest filing for a ticker (-> ./output/)
holon fetch --ticker NVDA

# Query consolidated facts in a built holon (in-memory SPARQL)
holon query --in output/0000320193-23-000106.holon.jsonld --element us-gaap:Assets

From a source checkout, just wraps the same CLI as a shorthand: just holon-build 320193 0000320193-23-000106 and just holon-fetch NVDA.

View & explore

Built holons render in the RoboSystems Holon Viewer — a browser-based reader that renders the financial statements and lets you ask questions of the report with AI:

• Hosted: https://holon.robosystems.ai/ — open a holon.jsonld and explore the statements, notes, and dimensional facts, or chat with the report.
• Source: https://github.com/RoboFinSystems/robosystems-holon-viewer — run it locally or self-host.

The viewer reads a holon entirely client-side, so a single holon.jsonld is a complete, portable, self-describing report.

License

This project is licensed under the MIT License - see the LICENSE file for details.

MIT © 2026 RFS LLC