finir 0.1.0__tar.gz

finir-0.1.0/.gitignore

@@ -0,0 +1,48 @@
+# Python
+__pycache__/
+*.py[cod]
+*.egg-info/
+*.egg
+build/
+dist/
+.eggs/
+.installed.cfg
+pip-wheel-metadata/
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+
+# Testing / coverage
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+.coverage.*
+coverage.xml
+htmlcov/
+
+# Local databases / runtime artifacts
+*.db
+*.sqlite
+*.sqlite3
+eif.db
+data/
+.eif/
+
+# Secrets & environment
+.env
+.env.*
+!.env.example
+
+# Editors / OS
+.idea/
+.vscode/
+*.swp
+.DS_Store
+Thumbs.db
+
+# Docs build
+site/

finir-0.1.0/CHANGELOG.md

@@ -0,0 +1,55 @@
+# Changelog
+
+All notable changes to FinIR are documented here. Format based on
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/); versioning follows
+[SemVer](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2026-08-31
+
+First release of **FinIR** — a financial intermediate representation and incremental
+execution runtime for AI systems.
+
+> This repository previously hosted a different project (an economic-event
+> framework). That direction has been **retired**; FinIR is a new project with a new
+> purpose. No results from the previous project are carried over or presented as
+> FinIR results.
+
+### Added
+
+- **Financial IR** (`finir.ir`): typed computation modules with an expression AST, a
+  `.finir` textual format, a parser, a lossless JSON interchange format, and a
+  validator.
+- **Finance-aware type system** (`finir.types`): `money[CCY]`, `percentage`, `ratio`,
+  `days`, `quantity`, `rate`, `series`, `scenario`, `scalar`, `bool`, with a compile-
+  time algebra (e.g. `money/money → ratio`; `money + days` and `USD + ZAR` are errors).
+- **Compiler passes** (`finir.compiler`): validation, type checking, constant
+  folding, common-subexpression elimination, dead-node elimination, dependency
+  pruning, scenario-vectorization analysis, fusion analysis, cache planning.
+- **Incremental runtime** (`finir.runtime`): dependency-aware engine that recomputes
+  only a changed input's downstream cone and reuses the rest in O(1); computation
+  cache with hit/reuse metrics; versioned `ModelState` snapshots.
+- **Scenario engine**: `what_if`, named `scenarios`, and vectorized `run_scenarios`
+  over million-row batches.
+- **Backends** (`finir.backends`): reference/vectorized CPU (NumPy) and an optional
+  GPU backend (CuPy), with a workload-aware dispatch planner.
+- **Kernel library** (`finir.kernels`): arithmetic, corporate finance, working
+  capital, time-value-of-money, and basic risk — plus a `@finir.kernel` extension
+  point.
+- **Standard library** (`finir.stdlib`): income-statement, working-capital,
+  operating-model, DCF, risk, and SaaS unit-economics templates.
+- **Agent integration**: structured-intent `apply_intent` and an optional
+  `IntentCompiler` interface with a dependency-free `MockIntentCompiler`.
+- **CLI** (`finir`): `run`, `compile`, `inspect`, `graph`, `benchmark`, `doctor`,
+  `version`.
+- **Graph export**: Graphviz DOT and JSON.
+- **Safe numerics**: configurable division-by-zero / non-finite handling; Decimal
+  path for money-sensitive scalar math.
+- **Benchmarks** (`benchmarks/`, `finir.benchmark`): incremental-vs-recompute and
+  scenario-batch suites that write real results with hardware metadata.
+- **Research**: Experiment 001 (incremental financial reasoning), Experiment 002
+  (backend dispatch), and a critical prior-art analysis.
+- **Docs** (`docs/`): architecture, IR, type system, compiler, runtime, caching,
+  scenarios, kernels, financial semantics, backends, agent integration, performance,
+  extending.
+
+[0.1.0]: https://github.com/Olyxee/finir/releases/tag/v0.1.0

finir-0.1.0/CITATION.cff

@@ -0,0 +1,23 @@
+cff-version: 1.2.0
+message: "If you use FinIR in your research, please cite it as below."
+title: "FinIR: a financial intermediate representation and incremental execution runtime"
+abstract: >-
+  FinIR is a compiler target and runtime for financial computation generated or
+  consumed by AI systems: a typed financial intermediate representation with
+  dependency-aware incremental execution, a finance-native cache, a scenario engine,
+  and workload-aware CPU/GPU dispatch.
+type: software
+authors:
+  - name: "FinIR Contributors"
+version: 0.1.0
+date-released: 2026-08-31
+license: Apache-2.0
+repository-code: "https://github.com/Olyxee/finir"
+url: "https://github.com/Olyxee/finir"
+keywords:
+  - financial computation
+  - intermediate representation
+  - compiler
+  - incremental computation
+  - scenario analysis
+  - ai infrastructure

finir-0.1.0/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or Derivative
+          Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 EIF Contributors
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

finir-0.1.0/NOTICE

@@ -0,0 +1,15 @@
+FinIR
+Copyright 2026 FinIR Contributors
+
+This product includes software developed as an open financial intermediate
+representation and incremental execution runtime for AI systems.
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not use this
+software except in compliance with the License. You may obtain a copy of the License
+at http://www.apache.org/licenses/LICENSE-2.0.
+
+Early research exploration was inspired by omni-modal scientific-reasoning systems
+(including work such as OmniScientist). FinIR is an independent project and contains
+no OmniScientist code, nor does it depend on OmniScientist at runtime.
+
+All example and benchmark data in this repository is synthetic.

finir-0.1.0/PKG-INFO

@@ -0,0 +1,258 @@
+Metadata-Version: 2.5
+Name: finir
+Version: 0.1.0
+Summary: A financial intermediate representation and incremental execution runtime for AI systems.
+Project-URL: Homepage, https://github.com/Olyxee/finir
+Project-URL: Repository, https://github.com/Olyxee/finir
+Project-URL: Documentation, https://github.com/Olyxee/finir/tree/main/docs
+Project-URL: Changelog, https://github.com/Olyxee/finir/blob/main/CHANGELOG.md
+Project-URL: Issues, https://github.com/Olyxee/finir/issues
+Author: FinIR Contributors
+Maintainer: Olyxee
+License: Apache-2.0
+License-File: LICENSE
+License-File: NOTICE
+Keywords: ai-infrastructure,compiler,financial-computation,incremental-computation,intermediate-representation,scenario-analysis
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Topic :: Software Development :: Compilers
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: numpy>=1.26
+Requires-Dist: rich>=13.7
+Requires-Dist: typer>=0.12
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == 'dev'
+Requires-Dist: jsonschema>=4.21; extra == 'dev'
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pre-commit>=3.7; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.1; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Requires-Dist: twine>=5.0; extra == 'dev'
+Provides-Extra: gpu
+Requires-Dist: cupy-cuda12x>=13.0; extra == 'gpu'
+Provides-Extra: viz
+Requires-Dist: graphviz>=0.20; extra == 'viz'
+Description-Content-Type: text/markdown
+
+# FinIR
+
+**A financial intermediate representation and incremental execution runtime for AI systems.**
+
+AI systems increasingly reason about finance, but their numerical execution still
+falls back to generated Python, spreadsheets, SQL, or generic tensor frameworks.
+FinIR gives financial reasoning a dedicated compiler target.
+
+<img width="1774" height="887" alt="image" src="https://github.com/user-attachments/assets/20298bac-2d01-4b65-8b83-01643e500851" />
+
+
+[![CI](https://github.com/Olyxee/finir/actions/workflows/ci.yml/badge.svg)](https://github.com/Olyxee/finir/actions/workflows/ci.yml)
+&nbsp;License: Apache-2.0 &nbsp;·&nbsp; Python 3.11+ &nbsp;·&nbsp; CPU-first, optional GPU
+
+```
+Financial Intent
+      ↓
+    FinIR
+      ↓
+Dependency Analysis
+      ↓
+Incremental Execution
+      ↓
+CPU / SIMD / GPU
+      ↓
+Financial Result
+```
+
+## Install
+
+```bash
+pip install finir
+```
+
+```bash
+python -c "import finir; print(finir.__version__)"
+finir --help
+finir doctor
+```
+
+CPU-first: `pip install finir` needs no GPU. Optional extras: `pip install "finir[gpu]"`
+(CuPy GPU backend), `pip install "finir[viz]"` (Graphviz SVG rendering). Develop from
+source with `git clone https://github.com/Olyxee/finir && cd finir && pip install -e ".[dev]"`.
+
+## Quick start
+
+```python
+from finir import FinancialModel
+
+model = FinancialModel()
+
+model.input("revenue", 500_000_000, currency="ZAR")
+model.input("cogs", 300_000_000, currency="ZAR")
+model.input("opex", 120_000_000, currency="ZAR")
+
+model.define("gross_profit", "revenue - cogs")
+model.define("ebitda", "gross_profit - opex")
+
+model.evaluate()
+
+scenario = model.what_if(cogs="+4%")
+
+print(scenario["ebitda"])
+```
+
+Change one assumption and FinIR recomputes **only the affected part of the graph**:
+
+```
+Input changed:
+  COGS
+
+Recomputed:
+  COGS → Gross Profit → EBITDA → Gross Margin → Cash Flow
+
+Reused (from cache):
+  Revenue, Payroll, Debt, Receivables, ...
+```
+
+## Why FinIR
+
+When an AI needs to compute *"increase supplier costs 7% and extend payment terms
+30→60 days,"* it usually translates that into arbitrary generated code — inefficient,
+non-deterministic, unaudited, and recomputed from scratch every turn. FinIR replaces
+that with a standard boundary:
+
+```
+financial intent  →  FinIR  →  deterministic, incremental financial execution
+```
+
+It understands financial semantics (revenue, COGS, gross margin, EBITDA, working
+capital, receivables/payables, free cash flow, NPV, unit economics, payment terms,
+…) and their computational dependencies — so it can recompute only what changed and
+reuse the rest.
+
+## What is a Financial IR?
+
+A typed computation graph with a finance-native type system:
+
+```
+revenue      = input money[ZAR]
+cogs         = input money[ZAR]
+gross_profit = revenue - cogs        : money[ZAR]
+gross_margin = gross_profit / revenue : ratio
+```
+
+`money - money → money` (same currency, else an error); `money / money → ratio`;
+`money + days` is a type error. See [docs/ir.md](https://github.com/Olyxee/finir/blob/main/docs/ir.md) and
+[docs/type-system.md](https://github.com/Olyxee/finir/blob/main/docs/type-system.md).
+
+## Architecture
+
+```
+Agent / Developer API → FinIR Builder → Financial IR → Compiler Passes
+  → Execution Plan → Incremental Runtime → Kernel Backend → CPU / SIMD / GPU
+```
+
+Each layer is cleanly separated. See [docs/architecture.md](https://github.com/Olyxee/finir/blob/main/docs/architecture.md).
+
+## Incremental execution
+
+Changing one input invalidates only its downstream cone; the next evaluation
+recomputes exactly those nodes and reuses everything else in O(1). This is FinIR's
+reason to exist — see [docs/runtime.md](https://github.com/Olyxee/finir/blob/main/docs/runtime.md) and
+[docs/caching.md](https://github.com/Olyxee/finir/blob/main/docs/caching.md).
+
+## Scenario engine
+
+`what_if`, named `scenarios`, and vectorized `run_scenarios` over million-row
+batches. See [docs/scenarios.md](https://github.com/Olyxee/finir/blob/main/docs/scenarios.md).
+
+## Financial types
+
+`money[CCY]`, `percentage`, `ratio`, `days`, `quantity`, `rate`, `series`,
+`scenario`, `scalar`, `bool` — enforced at compile time. See
+[docs/type-system.md](https://github.com/Olyxee/finir/blob/main/docs/type-system.md).
+
+## Kernels
+
+Arithmetic, corporate finance, working capital, time-value-of-money, and basic risk
+— plus a `@finir.kernel` extension point. Deliberately small (not a quant library).
+See [docs/kernels.md](https://github.com/Olyxee/finir/blob/main/docs/kernels.md).
+
+## Compiler passes
+
+Validation, type checking, constant folding, CSE, dead-node elimination, dependency
+pruning, scenario vectorization, fusion analysis, cache planning. Inspect with
+`finir compile model.finir --show-passes`. See [docs/compiler.md](https://github.com/Olyxee/finir/blob/main/docs/compiler.md).
+
+## Agent integration
+
+Core FinIR consumes **structured** intent (`apply_intent`); natural-language
+interpretation is an optional `IntentCompiler` layer (a dependency-free
+`MockIntentCompiler` ships for offline use). The model interprets; the runtime
+computes. See [docs/agent-integration.md](https://github.com/Olyxee/finir/blob/main/docs/agent-integration.md).
+
+## CPU / GPU dispatch
+
+CPU-first and fully usable with no optional dependencies. A workload-aware planner
+sends very large scenario batches to an optional CuPy GPU backend when present. See
+[docs/backends.md](https://github.com/Olyxee/finir/blob/main/docs/backends.md).
+
+## Benchmarks
+
+```bash
+finir benchmark --full
+python benchmarks/run_benchmarks.py     # writes benchmarks/results/
+```
+
+On the reference machine: **1.7×–2.2× faster** iterative reasoning vs. full
+recompute (up to 99.6% cache hits), and ~1,000,000 scenarios in ~46 ms on CPU. All
+numbers are measured, never hard-coded. See [docs/performance.md](https://github.com/Olyxee/finir/blob/main/docs/performance.md).
+
+## Research
+
+- [research/experiment_001_incremental_financial_reasoning.md](https://github.com/Olyxee/finir/blob/main/research/experiment_001_incremental_financial_reasoning.md) — incremental vs. full recompute
+- [research/experiment_002_backend_dispatch.md](https://github.com/Olyxee/finir/blob/main/research/experiment_002_backend_dispatch.md) — CPU/GPU crossover (GPU unverified locally)
+- [research/prior_art.md](https://github.com/Olyxee/finir/blob/main/research/prior_art.md) — critical positioning vs. spreadsheets, incremental-computation systems, JAX/XLA/MLIR, QuantLib, planning engines, and more
+
+We do **not** claim FinIR is a first or a breakthrough. The working hypothesis —
+that there is no widely-adopted open finance-specific IR designed as the execution
+boundary between AI financial intent and incremental computation — remains a
+hypothesis pending a formal prior-art review.
+
+## Extending FinIR
+
+Custom kernels, backends, and templates; a stable JSON IR for other-language
+bindings. See [docs/extending.md](https://github.com/Olyxee/finir/blob/main/docs/extending.md).
+
+## Roadmap
+
+- Larger real-model benchmarks and agent-trace evaluation.
+- Measured GPU dispatch thresholds on CUDA hardware.
+- Optional lowering onto a tensor compiler (XLA/MLIR) for very large graphs.
+- Language bindings (TypeScript/Rust) over the JSON IR.
+- Autodiff / sensitivities as an optional layer.
+
+## Contributing
+
+See [CONTRIBUTING.md](https://github.com/Olyxee/finir/blob/main/CONTRIBUTING.md). Quality gates: `ruff check .`,
+`ruff format --check .`, `mypy src`, `pytest`. CPU-only; no network for core tests.
+
+## Citation
+
+See [CITATION.cff](https://github.com/Olyxee/finir/blob/main/CITATION.cff).
+
+## Acknowledgements
+
+Early research exploration was inspired by omni-modal scientific-reasoning systems
+(including work such as OmniScientist). FinIR is **independent**: no OmniScientist
+code and no runtime dependency on it.
+
+## License
+
+Apache-2.0 — see [LICENSE](https://github.com/Olyxee/finir/blob/main/LICENSE).