boos
e0a5f57793
Vendor the rebranded BoosAPI Desktop client (Tauri + Vue) into metapi as a monorepo subdirectory under desktop/. Source only — node_modules, dist, Cargo target and the upstream .git history are excluded. desktop/ keeps its own independent Cargo workspace (desktop/src-tauri with crates/*); it is not part of the backend boosapi crate, so a `cargo check` at the metapi root still compiles only the backend. Build the desktop app from desktop/src-tauri per desktop/README.md. Note: app icons are still placeholder assets pending the final BoosAPI logo. The updater signing keys live outside the repo and are not included.
129 lines
4.4 KiB
Markdown
129 lines
4.4 KiB
Markdown
# Inicio rápido
|
|
|
|
## Instalación
|
|
|
|
Descarga el último instalador desde la [página de descarga](/es/download) o [GitHub Releases](https://github.com/BoosApi-Desktop/BoosApi/releases).
|
|
|
|
### macOS
|
|
|
|
| Chip | Archivo |
|
|
|------|---------|
|
|
| Apple Silicon (M1 / M2 / M3 / M4) | `BoosApi_x.x.x_aarch64.dmg` |
|
|
| Intel | `BoosApi_x.x.x_x64.dmg` |
|
|
|
|
1. Abre el `.dmg` y arrastra **BoosApi** a la carpeta **Aplicaciones**.
|
|
2. Inicia BoosApi. Si macOS bloquea la app, ve a **Configuración del Sistema → Privacidad y Seguridad** y haz clic en **Abrir de todas formas**.
|
|
|
|
::: warning macOS: "La app está dañada" o "No se puede verificar el desarrollador"
|
|
Si ves alguno de estos mensajes, abre Terminal y ejecuta:
|
|
|
|
```bash
|
|
xattr -c /Applications/BoosApi.app
|
|
```
|
|
|
|
Luego inicia la app de nuevo. Esto elimina la marca de cuarentena que macOS aplica a las descargas no firmadas.
|
|
:::
|
|
|
|
### Windows
|
|
|
|
| Arquitectura | Archivo |
|
|
|-------------|---------|
|
|
| x64 (la mayoría de PCs) | `BoosApi_x.x.x_x64-setup.exe` |
|
|
| ARM64 | `BoosApi_x.x.x_arm64-setup.exe` |
|
|
|
|
Ejecuta el instalador y sigue el asistente. Inicia BoosApi desde el menú Inicio o el acceso directo del escritorio.
|
|
|
|
### Linux
|
|
|
|
| Formato | Arquitectura | Archivo |
|
|
|---------|-------------|---------|
|
|
| Debian / Ubuntu | x64 | `BoosApi_x.x.x_amd64.deb` |
|
|
| Debian / Ubuntu | ARM64 | `BoosApi_x.x.x_arm64.deb` |
|
|
| Fedora / openSUSE | x64 | `BoosApi_x.x.x_x86_64.rpm` |
|
|
| Fedora / openSUSE | ARM64 | `BoosApi_x.x.x_aarch64.rpm` |
|
|
| Cualquier distro | x64 | `BoosApi_x.x.x_amd64.AppImage` |
|
|
| Cualquier distro | ARM64 | `BoosApi_x.x.x_aarch64.AppImage` |
|
|
|
|
```bash
|
|
# Debian / Ubuntu
|
|
sudo dpkg -i BoosApi_x.x.x_amd64.deb
|
|
|
|
# Fedora / openSUSE
|
|
sudo rpm -i BoosApi_x.x.x_x86_64.rpm
|
|
|
|
# AppImage (cualquier distro)
|
|
chmod +x BoosApi_x.x.x_amd64.AppImage
|
|
./BoosApi_x.x.x_amd64.AppImage
|
|
```
|
|
|
|
---
|
|
|
|
## Configuración inicial
|
|
|
|
### 1. Abrir configuración
|
|
|
|
Inicia BoosApi y haz clic en el **ícono de engranaje** en la parte inferior de la barra lateral, o presiona <kbd>Cmd/Ctrl</kbd>+<kbd>,</kbd>.
|
|
|
|
### 2. Añadir un proveedor
|
|
|
|
Navega a **Configuración → Proveedores** y haz clic en el botón **+**.
|
|
|
|
1. Introduce un nombre para mostrar (ej. *OpenAI*).
|
|
2. Selecciona el tipo de proveedor (OpenAI, Anthropic, Google Gemini, etc.).
|
|
3. Pega tu clave API.
|
|
4. Confirma la **URL base** — el endpoint oficial está prellenado para los tipos integrados.
|
|
|
|
::: tip
|
|
Puedes añadir tantos proveedores como quieras. Cada proveedor gestiona su propio conjunto de claves API y modelos de forma independiente.
|
|
:::
|
|
|
|
### 3. Obtener modelos
|
|
|
|
Haz clic en **Obtener modelos** para obtener la lista de modelos disponibles de la API del proveedor. También puedes añadir IDs de modelos manualmente si es necesario.
|
|
|
|
### 4. Establecer un modelo predeterminado
|
|
|
|
Ve a **Configuración → Modelo predeterminado** y elige el proveedor y el modelo que las nuevas conversaciones deben usar por defecto.
|
|
|
|
---
|
|
|
|
## Tu primera conversación
|
|
|
|
1. Haz clic en **Nuevo chat** en la barra lateral (o presiona <kbd>Cmd/Ctrl</kbd>+<kbd>N</kbd>).
|
|
2. Selecciona un modelo del selector de modelos en la parte superior del chat.
|
|
3. Escribe un mensaje y presiona <kbd>Enter</kbd>.
|
|
4. BoosApi transmite la respuesta en tiempo real. Los modelos que soportan bloques de pensamiento (ej. Claude, DeepSeek R1) muestran el proceso de razonamiento en una sección plegable.
|
|
|
|
---
|
|
|
|
## Atajos
|
|
|
|
| Atajo | Acción |
|
|
|-------|--------|
|
|
| <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>A</kbd> | Mostrar / ocultar ventana actual |
|
|
| <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Alt</kbd>+<kbd>A</kbd> | Mostrar / ocultar todas las ventanas |
|
|
| <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>W</kbd> | Cerrar ventana |
|
|
| <kbd>Cmd/Ctrl</kbd>+<kbd>N</kbd> | Nueva conversación |
|
|
| <kbd>Cmd/Ctrl</kbd>+<kbd>,</kbd> | Abrir configuración |
|
|
| <kbd>Cmd/Ctrl</kbd>+<kbd>K</kbd> | Paleta de comandos |
|
|
| <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>G</kbd> | Alternar pasarela API |
|
|
|
|
---
|
|
|
|
## Datos y copia de seguridad
|
|
|
|
### Directorios de datos
|
|
|
|
| Ruta | Contenido |
|
|
|------|----------|
|
|
| `~/.boosapi/` | Estado de la aplicación — base de datos, claves de cifrado, base vectorial, certificados SSL |
|
|
| `~/Documents/boosapi/` | Archivos de usuario — imágenes, documentos, copias de seguridad |
|
|
|
|
---
|
|
|
|
## Próximos pasos
|
|
|
|
- [Configurar proveedores](./providers) — añadir y gestionar proveedores de IA
|
|
- [Servidores MCP](./mcp) — conectar herramientas externas para ampliar las capacidades de IA
|
|
- [Pasarela API](./gateway) — exponer tus proveedores como servidor API local
|