colombia-open

Datos públicos de Colombia, listos para usar en Python.

Los datos públicos de Colombia existen, pero cada uno en su portal y en su formato. Aquí los encuentras limpios, en un mismo lugar y listos para cargar, con su fuente y licencia siempre a la vista.

ParaAnalistasPeriodistas de datosInvestigadoresAgentes de IA
Ver catálogoVer en GitHub

Así se usa

Sin cuentas, sin tokens, sin lidiar con decenas de portales distintos.

$ pip install colombia-open

from colombia_open import ColombiaOpen

hub = ColombiaOpen()
municipios = hub.load_polars("municipios")
municipios.filter(municipios["cod_dpto"] == "05")  # municipios de Antioquia

hub.resolve_municipios(["medellín", "BOGOTÁ, D.C.", "santiago de cali"])
# tolera tildes y mayúsculas → cod_mpio: 05001, 11001, 76001

Hace coincidencia exacta tras normalizar tildes y mayúsculas, no adivina apodos — por eso el ejemplo usa "santiago de cali" y no "cali".

Paquete en PyPI. ¿Usas agentes de IA? Instala el extra mcp y conecta el catálogo a tu agente — ver servidor MCP.

Roadmap

Crece una fuente a la vez, de punta a punta. Esta tabla es el mapa completo: implementadas y por venir.

DominioFuente oficialEstado
Geografía (códigos + centroides)DANE — DIVIPOLA Códigos municipios (vía datos.gov.co)Implementada
Geografía (geometría de polígonos municipales)DANE (Marco Geoestadístico Nacional), vía HDX — Colombia Subnational Administrative Boundaries (cod-ab-col)Implementada
Demografía (censo / proyecciones)DANE — Proyecciones de población municipal por área geográfica 2018-2042Implementada
Educación (directorio de establecimientos)MEN — Directorio único de establecimientos educativos (vía datos.gov.co)Implementada
Educación (Saber 11)ICFES — Resultados Saber 11, agregado por establecimiento (vía datos.gov.co)Implementada
Calidad del aireIDEAM — Calidad del Aire en Colombia (Promedio Anual), vía datos.gov.coImplementada
Macroeconomía (TRM)Superintendencia Financiera de Colombia (SUPERFINANCIERA) — TRM (vía datos.gov.co)Implementada
Infraestructura urbana / puntos de interésOpenStreetMap contributors, vía Geofabrik — extracto ColombiaImplementada
Seguridad y convivencia (hurto a personas)MinDefensa / Policía Nacional — Hurto a personas (vía datos.gov.co)Implementada
Seguridad y convivencia (lesiones personales)Policía Nacional (DIPON) — Lesiones personales y en accidente de tránsito (vía datos.gov.co)Implementada
Seguridad y convivencia (hurto por modalidades)Policía Nacional (DIPON) — Hurto por modalidades (vía datos.gov.co)Implementada
Vivienda / edificaciónDANE / CamacolPendiente
PobrezaDANEPendiente
Consumo eléctricoXM / UPMEPendiente
Economía municipal / finanzas territorialesDNP TerridataPendiente
SaludMinSalud — SISPROPendiente
ClimaIDEAMPendiente
ElectoralRegistraduríaPendiente
Mercado laboral (GEIH)DANE — microdatosPendiente — licencia restringida
Calidad de vida (ECV)DANE — microdatosPendiente — licencia restringida

¿Conoces una fuente pública que falta? Propónla en GitHub.

Contribuir

colombia-open es abierto y crece con quien lo usa. Hay tres formas de sumarse, ninguna requiere permiso previo.

01 · Datos

Propón una fuente

Una fuente oficial con endpoint verificable y licencia clara. Cada propuesta pasa por el mismo filtro: procedencia, vigencia y validación.

Proponer fuente

02 · Código

Escribe código

Toma un issue marcado para empezar, comenta que lo trabajas y sigue la guía: una fuente por PR, de punta a punta, con tests y docs.

Ver issues para empezar →Guía de contribución

03 · Comunidad

Conversa

Preguntas de uso, ideas aún sin forma o casos de uso que te gustaría resolver. Un buen lugar para empezar antes de abrir un issue.

Ir a Discussions

Al participar aceptas el Código de Conducta. ¿Encontraste una vulnerabilidad? Repórtala en privado — ver la política de seguridad.