Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/RubenDarioGuerreroNeira/Ecosistema-IA-Colombia/llms.txt

Use this file to discover all available pages before exploring further.

Salud IA Bot is an intelligent public health assistant built with NestJS and Meta LLaMA 3.1 70B (via OpenRouter). It connects Colombian citizens to accurate, up-to-date health information directly through Telegram — from SIVIGILA epidemiological statistics and composite disease risk scores to regional health provider lookups and dynamic charts.

Introduction

Understand the system architecture, data sources, and how the bot works end-to-end.

Quickstart

Clone, configure, seed data, and have the bot running locally in minutes.

Configuration

All environment variables, Telegram token setup, and OpenRouter model configuration.

Core Features

Explore epidemiological analytics, risk scoring, charts, mental health, and more.

What Salud IA Bot Does

Salud IA Bot serves as a bridge between Colombia’s complex public health data systems and everyday citizens. Using Retrieval-Augmented Generation (RAG), it injects real data from SIVIGILA, the PAI vaccination program, and air quality sensors into every AI prompt — eliminating hallucinations and ensuring responses are grounded in verified statistics.

Epidemiological Analytics

Query SIVIGILA disease data, rankings, gender/age breakdowns, and urban vs. rural comparisons.

Predictive Risk Scoring

Composite ML scoring (BAJO → CRÍTICO) across four weighted dimensions for any disease and region.

Dynamic Charts

Instant bar, pie, and line charts for disease trends, air quality, and vaccination coverage.

Mental & Sexual Health

CIE-10 mental health profiles, sexual health Q&A, and care pathway guidance.

Local Provider Search

Find hospitals and clinics in Antioquia, Boyacá, Cali, and Yopal — with GPS proximity support.

Early Warning Alerts

Automated epidemic threshold detection with structured outbreak notifications.

Get Started in 3 Steps

1

Clone & Install

Clone the repository and install dependencies with npm install.
2

Configure Environment

Set your TELEGRAM_BOT_TOKEN and OPENROUTER_API_KEY in a .env file. See the Configuration guide for all variables.
3

Seed Data & Launch

Run npm run import:data to populate the SQLite database, then start with npm run start:dev. Your bot is live on Telegram.

Architecture at a Glance

Salud IA Bot is built on NestJS with a modular service architecture. Every message passes through BotUpdate, which routes intent to specialized services — analytics, prediction, charts, or regional lookup — before optionally calling the LLaMA 3.1 model with an enriched RAG context.

System Architecture

Service map, module structure, and request routing flow.

Data Pipeline

XML ingestion, SQLite migration, and TypeORM persistence strategy.

AI Engine

OpenRouter integration, RAG prompting, and model configuration.

Deployment

Running on Render, environment variables, and production best practices.

Build docs developers (and LLMs) love