Guía de uso

Guía de Uso

¡Qué alegría! Gracias por animarte a usar a Lunita (aunque a veces sea un poco impredecible, ¡ella está muy feliz de ayudarte!). Sigue estos pasos para ponerla en marcha rápidamente.

Requisitos previos

Antes de comenzar, asegúrate de contar con lo siguiente:

• Python 3.10 o superior.
• Gestor de paquetes pip.
• Una cuenta y API Key en Groq.

Instalación

Lunita está disponible en PyPI, por lo que puedes instalarla fácilmente con el siguiente comando:

pip install lunita-mini

Uso básico

Para interactuar con Lunita, es fundamental entender cómo configurar sus componentes principales.

Configuración inicial

El corazón de la librería es la clase ConfigurarEstrellas. Aquí es donde defines las credenciales y el comportamiento de Lunita.

from lunita import ConfigurarEstrellas

# Inicialización básica
configuracion = ConfigurarEstrellas(token="tu_token_de_groq")

Parámetros disponibles:

• token (Obligatorio): Tu API Key de Groq.
• modelo (Opcional): El modelo de Groq a utilizar (ej. openai/gpt-oss-120b).
• instrucciones_adicionales (Opcional): Personaliza la personalidad de Lunita.
• historial (Opcional): Lista de mensajes previos.
• max_mensajes (Opcional): Límite de mensajes a guardar (default: 15).
• temperatura (Opcional): Nivel de creatividad (default: 1.1).

Iniciar una Sesión

Una vez que tengas lista tu configuración, es momento de hablar con Lunita usando la clase Sesion. Esta clase se encarga de gestionar el flujo de la charla y mantener la memoria de lo que han platicado.

from lunita import ConfigurarEstrellas, Sesion

# 1. Preparamos los ajustes
configuracion = ConfigurarEstrellas(token="tu_token_aqui", modelo="llama-3.1-70b-versatile")

# 2. Iniciamos la sesión
sesion = Sesion(configuracion=configuracion)

# 3. ¡A platicar!
respuesta = sesion.predecir("¿Qué tal tu día, Lunita?")
print(respuesta)

Métodos y propiedades clave:

• predecir(entrada: str): Es el método principal para enviar mensajes. Envía tu texto a Lunita y espera a que ella responda.

  • Retorno: Devuelve un string con la respuesta de Lunita.
  • Errores: Si algo sale mal (problemas de conexión o de API), Lunita lanzará un error descriptivo para que sepas qué pasó.

• historial: Es una propiedad que te permite asomarte a la memoria de la sesión actual.

  • Devuelve una lista con todos los mensajes intercambiados (tanto los tuyos como los de Lunita) en el formato oficial de mensajes.
  • Útil para guardar la conversación y retomarla después.

Por ejemplo, si quisieras contar el número de mensajes:

print(f"Llevamos {len(sesion.historial)} mensajes intercambiados.")

Sesión Asíncrona (Streaming 🔮)

Si estás construyendo una aplicación web, un bot de chat o simplemente no quieres que tu programa se quede congelado esperando, la SesionAsincrona es tu mejor amiga. Esta clase permite que Lunita te responda "en vivo", entregándote fragmentos de su predicción conforme los va imaginando.

import asyncio
from lunita import ConfigurarEstrellas, SesionAsincrona

async def chat():
    # 1. Configuramos a Lunita
    config = ConfigurarEstrellas(token="tu-token")
    
    # 2. Iniciamos la sesión asíncrona
    sesion = SesionAsincrona(configuracion=config)
    
    print("🔮 Lunita está consultando su bola de cristal...")
    
    # 3. ¡Streaming en vivo! 
    # Usamos 'async for' para recibir la respuesta poco a poco
    async for fragmento in sesion.predecir("¿Qué me depara el futuro?"):
        print(fragmento, end="", flush=True)

# Ejecutar el evento asíncrono
asyncio.run(chat())

Recetas de Personalidad 🍲

¿No sabes qué poner en instrucciones_adicionales? Prueba estas combinaciones rápidas para cambiarle el humor a Lunita:

1. La Tarotista Dramática Perfecta para lecturas de cartas simuladas.

config = ConfigurarEstrellas(
    token="...",
    temperatura=1.4, # Muy creativa
    instrucciones_adicionales="Eres una tarotista dramática. Inventa cartas que no existen."
)

2. La Amiga Intensa Para cuando quieres mucho texto y emojis.

config = ConfigurarEstrellas(
    token="...",
    temperatura=1.0,
    instrucciones_adicionales="Usa MUCHOS emojis y escribe mensajes largos y emocionados."
)

3. Modo "Casi" Serio Si necesitas respuestas un poco más directas (aunque Lunita siempre será Lunita).

config = ConfigurarEstrellas(
    token="...",
    temperatura=0.6, # Menos alucinaciones
    instrucciones_adicionales="Sé breve. Intenta acertar aunque seas torpe."
)

---

Siguiente paso: Mira los Ejemplos Prácticos 👉