feat(desktop): embed BoosAPI Desktop client as a subproject
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.
This commit is contained in:
boos
@@ -0,0 +1,128 @@
|
||||
# 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
|
||||
Reference in New Issue
Block a user