chile-hub

La última milla de los datos oficiales de Chile

Datos públicos de Chile, listos para cruzar.

chile-hub reúne capas de distintas instituciones, normaliza claves, valida su calidad y publica archivos reproducibles. Explora los datos, compara comunas o consulta Parquet directamente con SQL.

Proyecto independiente. Las fuentes oficiales siempre prevalecen.

22 capas publicadas · 2 candidatas activas 346 comunas en el catálogo 100% códigos CUT normalizados SHA-256 integridad verificable
PUNTO DE PARTIDA

¿Qué necesitas hacer?

Ve directamente a los datos o a una herramienta. No necesitas crear una cuenta.

Mapa territorial

Mapa con límites simplificados de 345 de 346 comunas (Antártica sin geometría). La capa GeoParquet sigue en evaluación y no forma parte del bundle público. Selecciona una comuna para abrir su ficha.
Cargando mapa…

Encuentra una comuna y descarga el resultado

Filtra las 346 comunas por nombre, código CUT, provincia o región. Descarga un CSV con los resultados filtrados o abre una ficha comunal.

Listado de comunas de Chile con códigos CUT, población y coordenadas
Código CUT Comuna Provincia Región Población Est. Coordenadas


Cargando comunas...

Lleva los datos a tu proyecto

Consume archivos publicados sin clonar el repositorio ni instalar el helper.

Python + Polars

Carga el Parquet publicado directamente desde cualquier notebook o servicio.
import io

import polars as pl
import requests

url = "https://tooltician.com/chile-hub/data/normalized/comunas.parquet"
df = pl.read_parquet(io.BytesIO(requests.get(url, timeout=60).content))

DuckDB directo

Consulta el archivo remoto con SQL, sin descargarlo manualmente.
SELECT *
FROM read_parquet('https://tooltician.com/chile-hub/data/normalized/comunas.parquet')
LIMIT 10;

JSON + curl

Descarga un artefacto abierto con una herramienta disponible en cualquier entorno.
curl -L "https://tooltician.com/chile-hub/data/normalized/comunas.json" \
  -o comunas.json

Consulta los datos sin instalar nada

Selecciona una consulta de ejemplo o escribe la tuya. DuckDB funciona en tu navegador; el motor se carga al ejecutar.
Ctrl + Enter para ejecutar

Herramientas para trabajar con los datos

Además de archivos listos para descargar, el paquete incluye resolutores territoriales y controles de calidad consultables.

Resolución de entidades

resolve_comunas()

Convierte nombres de comunas en códigos CUT normalizados (normaliza acentos y mayúsculas; match exacto).

from chile_hub import ChileHub
hub = ChileHub()
hub.resolve_comunas(["santiago", "nunoa"])

Reverse geocoding

resolve_by_coords()

De un par de coordenadas a la comuna que las contiene — sin servicios externos ni claves.

hub.resolve_by_coords(
    [(-33.4489, -70.6693)]  # centro de Santiago
)

Geometría comunal

GeoParquet

Límites poligonales de 345 de las 346 comunas en GeoParquet (Antártica es un gap upstream documentado). Capa en carril candidato con revisión en curso: disponible para evaluación local, aún no incluida en el bundle público ni en el catálogo. Ver carriles de publicación.

Candidato: consulta la ficha y los requisitos de uso antes de incorporarlo.

Indicadores económicos

UF · UTM · IPC

Series diarias y mensuales con fechas de vigencia explícitas; IPC desde la fuente oficial INE. Comprueba la frescura antes de usarlas.

hub.load_polars("indicadores")

Distribución abierta

PyPI · Hugging Face · DCAT

El paquete instalable, el mirror en Hugging Face Hub y el catálogo DCAT data.json para descubrimiento.

pip install chile-hub

Salud verificable

build → verify → publish

Cada build valida contratos, integridad SHA-256, frescura y procedencia antes de publicar.

hub.health()
Unidad de Fomento (UF)
Dólar Observado
Euro
U. Tributaria Mensual (UTM)

Paquete descargable

ZIP reproducible del hub listo para mover, adjuntar o consumir fuera del repo.
Cargando...
Verificar integridad del archivo
Verificar integridad
curl -L -o data/normalized/chile-hub-publishable-bundle.zip https://github.com/cortega26/chile-hub/releases/latest/download/chile-hub-publishable-bundle.zip
curl -L -o data/normalized/chile-hub-publishable-bundle.zip.sha256 https://github.com/cortega26/chile-hub/releases/latest/download/chile-hub-publishable-bundle.zip.sha256
shasum -a 256 -c data/normalized/chile-hub-publishable-bundle.zip.sha256

Qué datos puedes cruzar hoy

Cada capa nueva pasa un filtro de utilidad real, estabilidad de la fuente y licencia verificable. Lo que está publicado funciona; lo que está en evaluación, todavía no.

Territorio

Regiones, provincias, comunas, códigos CUT, coordenadas y población de referencia.

Disponible

Economía

UF, UTM, dólar, euro e IPC en series normalizadas para análisis y productos.

Disponible

Demografía

Población, proyecciones, hogares y estructura etaria con claves territoriales comunes.

Disponible

Gobierno local

Presupuestos, servicios, infraestructura y directorios municipales reutilizables.

En evaluación

Educación y salud

Establecimientos e indicadores públicos con cobertura y licencias verificables.

Disponible

Medioambiente

Clima, agua, energía y territorio para cruces longitudinales y geográficos.

En investigación

Cómo comprobar la calidad de una capa

Cada capa incluye la información que necesitas para decidir si sirve en producción, análisis o investigación.

Procedencia

Fuente primaria, método de acceso, timestamp y snapshot crudo para auditoría.

Contratos

Esquemas, tipos y claves estables con validaciones que detienen publicaciones inválidas.

Reutilización

Licencia, atribución y redistribución documentadas por dataset, sin ambigüedad.

Integridad

Manifest, hashes SHA256, cobertura, freshness y drift disponibles en cada build.

Leer el caso de estudio completo →

Estado del pipeline

Cargando estado del hub...
Detalles técnicos y reportes
Cargando...
Cargando...

— Estado operativo

Resumen de salud de los datasets del hub: frescura, cobertura, modo de extracción y estado de validación. Actualizado: —.

Datasets: — — ok — warn — error · Live: — Fallback: — Stale: — Drifted: —

Historial reciente: capas ok / warn / error por build

Dataset Estado Modo Validación Frescura Cobertura Drift Advertencias

¿Falta un dataset útil?

Propón una fuente o muestra cómo utilizaste una capa. Cada incorporación se evalúa por utilidad, procedencia y condiciones de reutilización.

Apoya el mantenimiento del proyecto

Si chile-hub te ahorra horas de limpieza, puedes ayudar a sostener extractores, validaciones y documentación pública.

Datos trazables, de la fuente a tu análisis.

chile-hub complementa a datos.gob.cl y a las instituciones fuente. Las capas derivadas documentan su origen, claves y condiciones de uso.

Hecho en Chile · GitHub · GitHub Sponsors · Buy Me a Coffee · LinkedIn