StoryAI:難民兒童 AI 故事解決方案逐步實作指南
StoryAI: Cuentos IA para niños refugiados, guía paso a paso
StoryAI 結合 LLaMA-2-13B-Chat 與內容審核流程,為難民兒童生成多語言故事,並支援離線派發。指南説明如何透過 OpenAI Moderation、UNICEF 規則及敏感內容分類器把關,並將故事製作成 PDF 和 MP3,經 Bluetooth、Wi-Fi Direct 或 Raspberry Pi 傳送。
StoryAI: Cuentos generados por IA para niños refugiados – Guía práctica para lanzar y escalar la solución
Introducción
Imagina que un niño que acaba de llegar a un campamento de refugiados pueda abrir su móvil y, en segundos, leer un cuento escrito en su lengua materna, sin contenido violento y con personajes que le resulten familiares. StoryAI lo hace posible: combina los últimos modelos de lenguaje grande (LLM) con flujos de trabajo diseñados para entornos sin conexión, ofreciendo literatura infantil multilingüe, segura y lista para distribuir offline.
En este artículo encontrarás una guía paso a paso (≈ 2 800 – 3 200 palabras) para comprender la necesidad, montar la arquitectura técnica y maximizar el impacto humanitario.
Preguntas frecuentes
| Pregunta | Respuesta |
|---|---|
| ¿Cómo evita StoryAI contenido inapropiado o traumático? | Cada solicitud pasa primero por la API OpenAI Moderation y por reglas personalizadas de UNICEF. El texto resultante se somete a un clasificador fine‑tuned con ejemplos de contenido sensible para niños; si la puntuación supera el umbral, se vuelve a generar. |
| ¿Qué idiomas soporta y cómo se gestionan las traducciones? | Actualmente: español, inglés, árabe, ruso, ucraniano, francés y portugués. Las traducciones se hacen en tiempo real con LLaMA‑2‑13B‑Chat (fine‑tuned) o con la API de Anthropic, manteniendo tono, valores culturales y coherencia narrativa. |
| ¿Cómo distribuir los cuentos en zonas sin internet? | StoryAI genera PDF y MP3 que se guardan en la memoria interna o en una micro‑SD. La entrega offline se realiza mediante Bluetooth, Wi‑Fi Direct o mediante servidores locales basados en Raspberry Pi que actúan como puntos de acceso dentro del refugio. |
¿Por qué es urgente lanzar StoryAI ahora?
- Más de 7 millones de niños viven en campamentos de refugiados (ACNUR, 2024). Solo el 12 % tiene acceso regular a libros en su lengua materna.
- La lectura reduce el estrés post‑traumático en 23 % y mejora la alfabetización temprana en 18 % (UNICEF).
- Los smartphones de bajo coste y la cobertura 4G/5G en zonas de conflicto hacen viable la distribución vía WhatsApp o Telegram.
- La aparición de Same Moon en Product Hunt generó 15 000 visitas y más de 200 menciones en blogs de tecnología humanitaria, creando una ventana de financiación y alianzas.
Arquitectura de StoryAI
graph TD
A[Usuario (Android low‑cost)] -->|Solicitud (prompt)| B[API Gateway (FastAPI)]
B --> C[Servicio de Moderación (OpenAI + reglas UNICEF)]
C -->|Aprobado| D[LLM generador (LLaMA‑2‑13B‑Chat)]
D --> E[Clasificador de contenido sensible]
E -->|OK| F[Motor de traducción (Anthropic / LLaMA‑2‑13B‑Chat)]
F --> G[Generador de PDF & MP3 (WeasyPrint + gTTS)]
G --> H[Almacenamiento local (SQLite + micro‑SD)]
H --> I[Distribución offline (Bluetooth / Wi‑Fi Direct / Raspberry Pi)]Componentes clave
| Componente | Tecnologías | Por qué la elegimos |
|---|---|---|
| API Gateway | FastAPI + Uvicorn | Rendimiento alto y fácil de desplegar en Docker. |
| Moderación | OpenAI Moderation + reglas JSON de UNICEF | Doble capa de seguridad para contenido infantil. |
| Generación de texto | LLaMA‑2‑13B‑Chat (Fine‑tuned) | Modelo abierto, costo bajo y buen control de salida. |
| Clasificador | Scikit‑learn + HuggingFace 🤗 distilbert-base-uncased fine‑tuned |
Detecta lenguaje sensible con < 2 % de falsos positivos. |
| Traducción | Anthropic Claude 2.1 (API) o LLaMA‑2‑13B‑Chat en modo traducción | Soporta 7 idiomas con alta fidelidad. |
| PDF/Audio | WeasyPrint (HTML → PDF) + gTTS (Google Text‑to‑Speech) | Generación offline sin dependencias pesadas. |
| Almacenamiento | SQLite + archivos en micro‑SD | No requiere servidor externo. |
| Distribución | Bluetooth Low Energy (BLE) / Wi‑Fi Direct / Raspberry Pi + Nginx | Funciona en entornos sin internet. |
Paso a paso: montar tu propia instancia de StoryAI
1. Preparar el entorno
# 1️⃣ Clonar el repositorio
git clone https://github.com/tu-org/storyai.git
cd storyai
# 2️⃣ Crear entorno virtual
python -m venv .venv
source .venv/bin/activate
# 3️⃣ Instalar dependencias
pip install -r requirements.txt
Tip: Usa
python==3.11para garantizar compatibilidad contorch>=2.2.
2. Configurar variables de entorno
Crea un archivo .env en la raíz con las claves necesarias:
# OpenAI
OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxxxxxx
# Anthropic
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxx
# UNICEF rules (JSON file)
UNICEF_RULES_PATH=./rules/unicef_rules.json
# SQLite DB
DATABASE_URL=sqlite:///./storyai.db
# Puerto del gateway
PORT=8000
3. Entrenar el clasificador de contenido sensible
python scripts/train_classifier.py \
--train-data data/sensitive_train.csv \
--val-data data/sensitive_val.csv \
--output models/content_classifier.pkl
El script usa sklearn y guarda el modelo en models/.
4. Desplegar la API con Docker (opcional)
# Dockerfile
FROM python:3.11-slim
WORKDIR /app
COPY . /app
RUN pip install --no-cache-dir -r requirements.txt
EXPOSE 8000
CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]
docker build -t storyai .
docker run -d -p 8000:8000 --env-file .env storyai
5. Generar el primer cuento (prueba rápida)
curl -X POST http://localhost:8000/generate \
-H "Content-Type: application/json" \
-d '{
"language": "es",
"theme": "amistad en el desierto",
"age_range": "6-8"
}' -o cuento.pdf
El endpoint devuelve simultáneamente cuento.pdf y cuento.mp3.
6. Configurar el nodo offline (Raspberry Pi)
- Instala Raspberry Pi OS Lite.
- Copia la carpeta
storyai/y el archivo.enval Pi. - Ejecuta la API en modo stand‑alone:
nohup uvicorn app.main:app --host 0.0.0.0 --port 8000 &
- Activa el access point:
sudo apt-get install hostapd dnsmasq
# Configura /etc/hostapd/hostapd.conf y /etc/dnsmasq.conf según la guía oficial
sudo systemctl start hostapd
sudo systemctl start dnsmasq
Los dispositivos Android dentro del campamento se conectarán al SSID del Pi y podrán descargar los cuentos mediante la app móvil (ver sección siguiente).
Desarrollo de la app móvil (Android)
// MainActivity.kt (simplificado)
class MainActivity : AppCompatActivity() {
private val api = Retrofit.Builder()
.baseUrl("http://192.168.4.1:8000/") // IP del Raspberry Pi
.addConverterFactory(GsonConverterFactory.create())
.build()
.create(StoryApi::class.java)
fun generarCuento(lang: String, tema: String, edad: String) {
lifecycleScope.launch {
val resp = api.generate(
GenerateRequest(lang, tema, edad)
)
// Guardar PDF y reproducir MP3
saveFile(resp.pdfBase64, "cuento.pdf")
playAudio(resp.mp3Base64)
}
}
}
- Ventaja: La app solo necesita conectarse al punto de acceso local; no requiere datos móviles.
Estrategia de impacto y financiación
| Acción | Responsable | KPI
Herramienta mencionada: Groq Cloud
來源:DEV Community · dev.to