跳到正文
DEV Community· LeoJulieta·· 23 小時前AI 評分22

StoryAI:難民兒童 AI 故事解決方案逐步實作指南

StoryAI: Cuentos IA para niños refugiados, guía paso a paso

AI 導讀

StoryAI 結合 LLaMA-2-13B-Chat 與內容審核流程,為難民兒童生成多語言故事,並支援離線派發。指南説明如何透過 OpenAI Moderation、UNICEF 規則及敏感內容分類器把關,並將故事製作成 PDF 和 MP3,經 Bluetooth、Wi-Fi Direct 或 Raspberry Pi 傳送。

正文

LeoJulieta

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?

  1. 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.
  2. La lectura reduce el estrés post‑traumático en 23 % y mejora la alfabetización temprana en 18 % (UNICEF).
  3. Los smartphones de bajo coste y la cobertura 4G/5G en zonas de conflicto hacen viable la distribución vía WhatsApp o Telegram.
  4. 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.11 para garantizar compatibilidad con torch>=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)

  1. Instala Raspberry Pi OS Lite.
  2. Copia la carpeta storyai/ y el archivo .env al Pi.
  3. Ejecuta la API en modo stand‑alone:
nohup uvicorn app.main:app --host 0.0.0.0 --port 8000 &
  1. 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