Metadata-Version: 2.5
Name: civitascope-data
Version: 0.0.1
Summary: Civitascope data engine: fetches Eurostat data, checks it against dataset cards and computes verifiable, sourced figures for infographics. Early development.
Project-URL: Homepage, https://civitascope.com
Project-URL: Repository, https://github.com/civitascope/civitascope-data
Author-email: András Horváth <github@andrashorvath.dev>
License-Expression: MIT
License-File: LICENSE
Keywords: data-to-text,duckdb,eurostat,infographics,open-data,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

# Civitascope Data

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

Civitascope turns open [Eurostat](https://ec.europa.eu/eurostat) data into verifiable, sourced infographics. **This package is the data engine**: it fetches data from the [Eurostat API](https://ec.europa.eu/eurostat/web/user-guides/data-browser/api-data-access/api-introduction), checks it against hand-reviewed dataset cards and computes the figures. Drawing the charts is the job of [civitascope-render](https://github.com/civitascope/civitascope-render); the website is [civitascope-web](https://github.com/civitascope/civitascope-web).

## 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://civitascope.com
- Source: https://github.com/civitascope/civitascope-data

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

## License

MIT
