Math Assistant CLI - Rommel Romero
Volver a proyectos
CLI + IA localHerramienta de terminal2026

Math Assistant CLI

Asistente CLI de matemáticas con Ollama local, streaming en tiempo real, Rich UI, control de contexto y exportación de sesiones a Markdown.

Problema

Probar asistentes locales con Ollama suele quedar en scripts mínimos. Este proyecto busca convertir esa prueba en una CLI cuidada, con buen feedback visual, contexto controlado y sesiones exportables.

Solución

CLI interactiva para matemáticas que usa Ollama como proveedor local mediante el SDK compatible de OpenAI. La interfaz usa Rich para paneles, tablas, Markdown y streaming progresivo.

Funcionalidades

  • Streaming token a token en terminal.
  • Comandos internos para ayuda, historial, limpieza y guardado.
  • Manejo explícito de errores de conexión/API con rollback del historial.
  • Configuración desde .env para modelo, URL, tokens y tamaño de contexto.

Decisiones Técnicas

La lógica del proveedor LLM queda encapsulada en OllamaClient, separada del bucle de terminal. El historial mantiene el mensaje de sistema y recorta solo mensajes recientes para no saturar el contexto.