Metadata-Version: 2.5
Name: figurastat
Version: 0.0.1
Summary: Open-source statistical agent: verifiable, sourced answers and charts from Eurostat data. Early development.
Project-URL: Homepage, https://figurastat.com
Project-URL: Repository, https://github.com/figurastat/figurastat
Author-email: András Horváth <figurastat@andrashorvath.dev>
License-Expression: MIT
License-File: LICENSE
Keywords: agent,data-to-text,eurostat,evaluation,infographics,llm,statistics
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# FiguraStat

> **Status: early development.** This release only reserves the package name. There is no usable functionality yet.

FiguraStat is an open-source statistical agent that answers natural-language questions with verifiable, sourced numbers and charts, built on the open [Eurostat API](https://ec.europa.eu/eurostat/web/user-guides/data-browser/api-data-access/api-introduction).

## Core principle

**The model never states a number on its own.** The LLM interprets the question, selects the right dataset and writes the answer; all calculation is done in code, and every figure is checked against the retrieved data before it is shown.

## Planned

- Dataset retrieval over the Eurostat catalogue
- Multi-step agent: search, fetch, compute, answer with source link
- Evaluation suite measuring dataset choice, numeric accuracy and refusals
- Infographic generation (country rankings, regional maps, then-vs-now) with faithfulness checks

## Links

- Website: https://figurastat.com
- Source: https://github.com/figurastat/figurastat

Data source: Eurostat (CC BY 4.0). FiguraStat is not affiliated with Eurostat or the European Commission.

## License

MIT
