VibeFlare

Qué problema resuelve

Cada prototipo necesita selección de modelos, autenticación y seguimiento de uso. VibeFlare reúne esas piezas tras un endpoint de tu cuenta Cloudflare, junto a un espacio de trabajo web. Tú gestionas instalación y acceso; Cloudflare proporciona y factura los servicios subyacentes.

Formas de usarlo

• Dar a un prototipo un único endpoint

  Crea una clave identificada y configura la URL base como la de tu instancia seguida de /v1. Elige un modelo de su catálogo, no el nombre de otro proveedor. Revoca la clave cuando retires el prototipo.

• Convertir audio en una transcripción guardada

  Abre Workspace > Audio, elige un modelo compatible, arrastra una grabación de hasta 25 MB y pulsa Transcribe. Reabre la conversación desde History. El archivo se envía al solicitar la transcripción.

• Entender para qué sirven los embeddings

  Embeddings convierte texto en vectores numéricos para búsqueda por similitud o agrupación. Escribe texto o importa .txt/.md y usa un modelo de embeddings. Son componentes para tu app, no una respuesta de chat ni una base de búsqueda lista.

Antes de empezar

• Una cuenta Cloudflare con acceso necesario a Workers AI y R2 activado; revisa los límites antes de crear recursos o enviar solicitudes.
• Para instalación por CLI: Node.js 22.12+, Bun y Git. El instalador obtiene las dependencias y Wrangler fijados.
• Un navegador para autenticarte y crear la cuenta propietaria. Conserva el recibo de instalación existente: identifica los recursos para actualizar.

Instalación y configuración

1. Elegir una ruta de instalación

   El botón Deploy to Cloudflare del README es la ruta más sencilla. La CLI añade un recibo local para estado, actualizaciones y desinstalación segura. Inspecciona una instalación existente antes de crear otra.

2. Instalar la CLI

   Clona el repositorio y ejecuta el instalador tras comprobar Node y Bun. Puedes usar ./vf desde el clon aunque ~/.local/bin aún no esté en PATH.

   git clone https://github.com/alexcodeplace/vibeflare.git
   cd vibeflare
   ./install.sh

3. Autenticar y crear la instalación

   Autentícate en el navegador, confirma cuenta y creación de recursos y ejecuta setup. Crea Worker, base de datos y almacenamiento y registra su propiedad; no es solo lectura.

   corepack pnpm --filter @vibeflare/worker exec wrangler login
   ./vf setup

4. Crear la cuenta propietaria y comprobar salud

   Abre la URL y completa /setup con passkey o GitHub. Crea una clave API para vf login e introdúcela localmente. Usa vf status y vf doctor; conserva el recibo fuera del código fuente.

   ./vf status
   ./vf doctor

Uso en tu proyecto

1. Elegir tarea y modelo compatible

   Workspace ofrece Text, Image, Audio y Embeddings. Los modelos corresponden a la tarea y las conversaciones pueden reabrirse en History. Image importa prompts escritos .txt/.md; no promete editar imágenes de referencia.

2. Conectar una aplicación

   Crea una clave revocable en API Keys, guárdala como secreto de la app y usa la URL de la instancia seguida de /v1. Exclude paid filtra acceso a modelos; no limita el gasto.

   https://YOUR-VIBEFLARE-URL/v1

3. Actualizar y limpiar según el recibo

   Usa vf update desde la nueva versión con el recibo existente para conservar D1/R2. Previsualiza la desinstalación antes de borrar; este comando no elimina recursos Cloudflare.

   ./vf uninstall --preview

Qué debes saber antes

Los recursos y el uso de IA de Cloudflare pueden generar cargos. Revisa los precios y límites vigentes del proveedor.