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:
@@ -0,0 +1,5 @@
|
||||
---
|
||||
layout: page
|
||||
---
|
||||
|
||||
<DownloadHero />
|
||||
@@ -0,0 +1,52 @@
|
||||
# Fonctionnalités
|
||||
|
||||
BoosApi est un espace de travail IA de bureau local-first. Cette page est mise à jour pour v0.0.85 avec les imports de fournisseurs, imports tiers, MCP, rendu HTML, sauvegardes et passerelle.
|
||||
|
||||
## Chat et modèles
|
||||
|
||||
- **Chat multi-fournisseurs** — Connectez OpenAI, Claude, Gemini, DeepSeek, Qwen et tout endpoint compatible OpenAI avec Base URL, API Path, headers et proxy.
|
||||
- **Onboarding fournisseur** — Utilisez les liens boosapi:// et l’import CC Switch pour importer des profils fournisseur après confirmation.
|
||||
- **Gestion des modèles** — Synchronisez les modèles distants, groupes, latence, capacités, contexte, sampling, profils de raisonnement et extra_body par modèle.
|
||||
- **Workflows de conversation** — Streaming, blocs de réflexion, versions de messages, branches, état de génération du titre, compression et réponses multi-modèles.
|
||||
|
||||
## AI Agent
|
||||
|
||||
- **Mode Agent** — Le modèle peut éditer des fichiers, exécuter des commandes et analyser du code dans un workflow contrôlé.
|
||||
- **Contrôle des permissions** — Choisissez revue standard, acceptation automatique des éditions ou accès complet avec sandbox de dossier de travail.
|
||||
- **Approbation et coûts** — Inspectez les appels d’outils, mémorisez les autorisations et suivez tokens/coûts par session.
|
||||
|
||||
## Rendu de contenu
|
||||
|
||||
- **Markdown et maths** — Rendu Markdown, code, tableaux, tâches et LaTeX dans les conversations streamées.
|
||||
- **Code, diagrammes et artifacts** — Monaco, Mermaid, D2 et panneau Artifact pour code, notes Markdown, rapports et aperçus.
|
||||
- **Fragments HTML** — Prévisualisez les fragments HTML générés avec les correctifs récents de stabilité du streaming.
|
||||
|
||||
## Recherche et connaissances
|
||||
|
||||
- **Recherche Web** — Tavily, Zhipu WebSearch, Bocha avec sources citées et génération de requêtes.
|
||||
- **Bases de connaissances locales** — Indexez vos documents avec sqlite-vec, réglez retrieval/rerank et inspectez les retours de récupération.
|
||||
- **Gestion du contexte** — Ajoutez fichiers, résultats de recherche, extraits, mémoires et sorties d’outils au contexte.
|
||||
|
||||
## Outils et extensions
|
||||
|
||||
- **Protocole MCP** — Exécutez des serveurs Model Context Protocol en stdio, SSE ou StreamableHTTP.
|
||||
- **Outils intégrés** — Utilisez @boosapi/fetch et la recherche de fichiers sans serveur séparé.
|
||||
- **Limite de boucle outils** — Configurez le nombre maximal de boucles MCP et récupérez mieux les sessions bloquées.
|
||||
|
||||
## Passerelle API
|
||||
|
||||
- **Passerelle locale** — Exposez OpenAI Chat Completions, OpenAI Responses, Claude natif et Gemini natif depuis l’app.
|
||||
- **Accès et observabilité** — Gérez clés, SSL/TLS, logs de requêtes et statistiques localement.
|
||||
- **Templates clients** — Templates pour Claude Code, Codex CLI, OpenCode, Gemini CLI et clients personnalisés.
|
||||
|
||||
## Import et sauvegarde
|
||||
|
||||
- **Imports tiers** — Importez ChatGPT, Cherry Studio et Kelivo avec aperçu, avertissements et gestion des doublons.
|
||||
- **Migration fournisseurs/fichiers** — Les imports Cherry Studio/Kelivo peuvent migrer fournisseurs, clés API et pièces jointes.
|
||||
- **Sauvegardes** — Sauvegarde/restauration via dossiers locaux, WebDAV ou stockage compatible S3.
|
||||
|
||||
## Bureau et sécurité
|
||||
|
||||
- **Chiffrement local** — État dans ~/.boosapi/, fichiers utilisateur dans ~/Documents/boosapi/, clés API protégées par AES-256.
|
||||
- **Intégration desktop** — Tray, always-on-top, raccourcis globaux, auto-start, proxy et vérification des mises à jour.
|
||||
- **11 langues** — Interface disponible en chinois simplifié/traditionnel, anglais, japonais, coréen, français, allemand, espagnol, russe, hindi et arabe.
|
||||
@@ -0,0 +1,74 @@
|
||||
# Passerelle API
|
||||
|
||||
## Qu'est-ce que la passerelle API ?
|
||||
|
||||
BoosApi inclut un serveur API local intégré qui expose vos fournisseurs configurés comme endpoints **compatibles OpenAI**, **natifs Claude** et **natifs Gemini**. Tout outil ou client utilisant l'un de ces protocoles peut utiliser BoosApi comme backend — sans clés API séparées ni services de relais.
|
||||
|
||||
Cas d'utilisation :
|
||||
|
||||
- Exécutez **Claude Code CLI**, **OpenAI Codex CLI**, **Gemini CLI** ou **OpenCode** via BoosApi.
|
||||
- Connectez vos extensions IDE à un unique endpoint géré localement.
|
||||
- Partagez un ensemble de clés de fournisseur entre de nombreux outils avec limitation de débit par clé.
|
||||
|
||||
---
|
||||
|
||||
## Démarrage
|
||||
|
||||
1. Ouvrez **Paramètres → Passerelle API** (ou appuyez sur <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>G</kbd>).
|
||||
2. Cliquez sur **Démarrer** pour lancer le serveur de passerelle.
|
||||
3. Par défaut, le serveur écoute sur `127.0.0.1:8080` (HTTP).
|
||||
|
||||
::: tip
|
||||
Activez le **Démarrage automatique** dans les paramètres de la passerelle pour lancer le serveur automatiquement au démarrage d'BoosApi.
|
||||
:::
|
||||
|
||||
---
|
||||
|
||||
## Gestion des clés API
|
||||
|
||||
1. Allez dans l'onglet **Clés API**.
|
||||
2. Cliquez sur **Générer une nouvelle clé**.
|
||||
3. Ajoutez optionnellement une **description** pour identifier chaque clé.
|
||||
4. Copiez la clé — elle n'est affichée qu'une seule fois.
|
||||
|
||||
---
|
||||
|
||||
## Modèles de configuration
|
||||
|
||||
### Claude Code CLI
|
||||
|
||||
```bash
|
||||
claude config set --global apiUrl http://127.0.0.1:8080
|
||||
claude config set --global apiKey boosapi-xxxx
|
||||
```
|
||||
|
||||
### OpenAI Codex CLI
|
||||
|
||||
```bash
|
||||
export OPENAI_BASE_URL=http://127.0.0.1:8080/v1
|
||||
export OPENAI_API_KEY=boosapi-xxxx
|
||||
codex
|
||||
```
|
||||
|
||||
### Gemini CLI
|
||||
|
||||
```bash
|
||||
export GEMINI_API_BASE=http://127.0.0.1:8080
|
||||
export GEMINI_API_KEY=boosapi-xxxx
|
||||
gemini
|
||||
```
|
||||
|
||||
### Client personnalisé
|
||||
|
||||
```
|
||||
URL de base : http://127.0.0.1:8080/v1
|
||||
Clé API : boosapi-xxxx
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Prochaines étapes
|
||||
|
||||
- [Démarrage rapide](./getting-started) — retourner au guide de démarrage rapide
|
||||
- [Configurer les fournisseurs](./providers) — ajouter les fournisseurs en amont vers lesquels la passerelle route
|
||||
- [Serveurs MCP](./mcp) — connecter des outils externes pour l'appel d'outils IA
|
||||
@@ -0,0 +1,136 @@
|
||||
# Démarrage rapide
|
||||
|
||||
## Installation
|
||||
|
||||
Téléchargez le dernier installateur depuis la [page de téléchargement](/fr/download) ou [GitHub Releases](https://github.com/BoosApi-Desktop/BoosApi/releases).
|
||||
|
||||
### macOS
|
||||
|
||||
| Puce | Fichier |
|
||||
|------|---------|
|
||||
| Apple Silicon (M1 / M2 / M3 / M4) | `BoosApi_x.x.x_aarch64.dmg` |
|
||||
| Intel | `BoosApi_x.x.x_x64.dmg` |
|
||||
|
||||
1. Ouvrez le `.dmg` et faites glisser **BoosApi** dans le dossier **Applications**.
|
||||
2. Lancez BoosApi. Si macOS bloque l'application, allez dans **Réglages Système → Confidentialité et sécurité** et cliquez sur **Ouvrir quand même**.
|
||||
|
||||
::: warning macOS : "L'app est endommagée" ou "Impossible de vérifier le développeur"
|
||||
Si vous voyez l'un de ces messages, ouvrez Terminal et exécutez :
|
||||
|
||||
```bash
|
||||
xattr -c /Applications/BoosApi.app
|
||||
```
|
||||
|
||||
Relancez ensuite l'application. Cela supprime l'indicateur de quarantaine que macOS applique aux téléchargements non signés.
|
||||
:::
|
||||
|
||||
### Windows
|
||||
|
||||
| Architecture | Fichier |
|
||||
|-------------|---------|
|
||||
| x64 (la plupart des PC) | `BoosApi_x.x.x_x64-setup.exe` |
|
||||
| ARM64 | `BoosApi_x.x.x_arm64-setup.exe` |
|
||||
|
||||
Exécutez l'installateur et suivez l'assistant. Lancez BoosApi depuis le menu Démarrer ou le raccourci bureau.
|
||||
|
||||
### Linux
|
||||
|
||||
| Format | Architecture | Fichier |
|
||||
|--------|-------------|---------|
|
||||
| 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` |
|
||||
| Toute distro | x64 | `BoosApi_x.x.x_amd64.AppImage` |
|
||||
| Toute 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 (toute distro)
|
||||
chmod +x BoosApi_x.x.x_amd64.AppImage
|
||||
./BoosApi_x.x.x_amd64.AppImage
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Configuration initiale
|
||||
|
||||
### 1. Ouvrir les paramètres
|
||||
|
||||
Lancez BoosApi et cliquez sur l'**icône d'engrenage** en bas de la barre latérale, ou appuyez sur <kbd>Cmd/Ctrl</kbd>+<kbd>,</kbd>.
|
||||
|
||||
### 2. Ajouter un fournisseur
|
||||
|
||||
Naviguez vers **Paramètres → Fournisseurs** et cliquez sur le bouton **+**.
|
||||
|
||||
1. Entrez un nom d'affichage (ex. *OpenAI*).
|
||||
2. Sélectionnez le type de fournisseur (OpenAI, Anthropic, Google Gemini, etc.).
|
||||
3. Collez votre clé API.
|
||||
4. Confirmez l'**URL de base** — l'endpoint officiel est pré-rempli pour les types intégrés.
|
||||
|
||||
::: tip
|
||||
Vous pouvez ajouter autant de fournisseurs que vous le souhaitez. Chaque fournisseur gère son propre ensemble de clés API et de modèles indépendamment.
|
||||
:::
|
||||
|
||||
### 3. Récupérer les modèles
|
||||
|
||||
Cliquez sur **Récupérer les modèles** pour obtenir la liste des modèles disponibles depuis l'API du fournisseur. Vous pouvez également ajouter des IDs de modèles manuellement si nécessaire.
|
||||
|
||||
### 4. Définir un modèle par défaut
|
||||
|
||||
Allez dans **Paramètres → Modèle par défaut** et choisissez le fournisseur et le modèle que les nouvelles conversations devront utiliser par défaut.
|
||||
|
||||
---
|
||||
|
||||
## Votre première conversation
|
||||
|
||||
1. Cliquez sur **Nouveau chat** dans la barre latérale (ou appuyez sur <kbd>Cmd/Ctrl</kbd>+<kbd>N</kbd>).
|
||||
2. Sélectionnez un modèle depuis le sélecteur de modèles en haut du chat.
|
||||
3. Tapez un message et appuyez sur <kbd>Entrée</kbd>.
|
||||
4. BoosApi diffuse la réponse en temps réel. Les modèles qui supportent les blocs de réflexion (ex. Claude, DeepSeek R1) affichent le processus de raisonnement dans une section repliable.
|
||||
|
||||
---
|
||||
|
||||
## Raccourcis
|
||||
|
||||
Voici les raccourcis clavier par défaut. Tous les raccourcis peuvent être personnalisés dans **Paramètres → Raccourcis**.
|
||||
|
||||
| Raccourci | Action |
|
||||
|-----------|--------|
|
||||
| <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>A</kbd> | Afficher / masquer la fenêtre actuelle |
|
||||
| <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>Alt</kbd>+<kbd>A</kbd> | Afficher / masquer toutes les fenêtres |
|
||||
| <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>W</kbd> | Fermer la fenêtre |
|
||||
| <kbd>Cmd/Ctrl</kbd>+<kbd>N</kbd> | Nouvelle conversation |
|
||||
| <kbd>Cmd/Ctrl</kbd>+<kbd>,</kbd> | Ouvrir les paramètres |
|
||||
| <kbd>Cmd/Ctrl</kbd>+<kbd>K</kbd> | Palette de commandes |
|
||||
| <kbd>Cmd/Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>G</kbd> | Basculer la passerelle API |
|
||||
|
||||
---
|
||||
|
||||
## Données et sauvegarde
|
||||
|
||||
### Répertoires de données
|
||||
|
||||
BoosApi stocke les données dans deux emplacements :
|
||||
|
||||
| Chemin | Contenu |
|
||||
|--------|---------|
|
||||
| `~/.boosapi/` | État de l'application — base de données, clés de chiffrement, base vectorielle, certificats SSL |
|
||||
| `~/Documents/boosapi/` | Fichiers utilisateur — images, documents, sauvegardes |
|
||||
|
||||
### Sauvegarde automatique
|
||||
|
||||
Allez dans **Paramètres → Sauvegarde** pour configurer les sauvegardes automatiques vers un répertoire local ou un serveur WebDAV.
|
||||
|
||||
---
|
||||
|
||||
## Prochaines étapes
|
||||
|
||||
- [Configurer les fournisseurs](./providers) — ajouter et gérer les fournisseurs IA
|
||||
- [Serveurs MCP](./mcp) — connecter des outils externes pour étendre les capacités IA
|
||||
- [Passerelle API](./gateway) — exposer vos fournisseurs comme serveur API local
|
||||
@@ -0,0 +1,64 @@
|
||||
# Serveurs MCP
|
||||
|
||||
## Qu'est-ce que MCP ?
|
||||
|
||||
Le [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) est un standard ouvert qui permet aux modèles IA d'interagir avec des outils et des sources de données externes. BoosApi agit comme un client MCP — vous ajoutez des serveurs MCP, et l'IA peut appeler les outils qu'ils exposent pendant une conversation.
|
||||
|
||||
---
|
||||
|
||||
## Protocoles de transport
|
||||
|
||||
BoosApi supporte trois protocoles de transport pour communiquer avec les serveurs MCP :
|
||||
|
||||
| Protocole | Connexion | Cas d'utilisation | Configuration |
|
||||
|-----------|-----------|------------------|---------------|
|
||||
| **Stdio** | Processus local | Outils installés sur votre machine, lancés via `npx`, `uvx`, `python`, etc. | `command` + `args` + `env` optionnel |
|
||||
| **SSE** | Serveur distant | Endpoint Server-Sent Events hébergé sur une machine distante | `url` |
|
||||
| **StreamableHTTP** | Serveur distant | Endpoint HTTP streaming, alternative plus récente à SSE | `url` |
|
||||
|
||||
---
|
||||
|
||||
## Ajouter des serveurs MCP
|
||||
|
||||
### Création par formulaire
|
||||
|
||||
1. Allez dans **Paramètres → Serveurs MCP**.
|
||||
2. Cliquez sur **Ajouter un serveur MCP**.
|
||||
3. Entrez un nom et sélectionnez le protocole de transport.
|
||||
4. Remplissez les champs pour votre protocole choisi.
|
||||
5. Cliquez sur **Enregistrer**.
|
||||
|
||||
### Import JSON
|
||||
|
||||
Cliquez sur **Import JSON** et collez un objet de configuration. BoosApi accepte le format JSON MCP standard :
|
||||
|
||||
```json
|
||||
{
|
||||
"mcpServers": {
|
||||
"fetch": {
|
||||
"command": "uvx",
|
||||
"args": ["mcp-server-fetch"]
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Outils intégrés
|
||||
|
||||
| Outil | Description |
|
||||
|-------|-------------|
|
||||
| **@boosapi/fetch** | Récupérer des pages web et des ressources HTTP |
|
||||
| **@boosapi/search-file** | Rechercher des fichiers sur votre système de fichiers local |
|
||||
|
||||
---
|
||||
|
||||
## Limite de boucle des outils
|
||||
|
||||
Settings -> MCP permet de configurer le nombre maximal d’itérations consécutives d’appels d’outils pour une réponse MCP. Réduisez la limite pour tester des serveurs inconnus, ou augmentez-la pour les workflows qui chaînent volontairement plusieurs outils.
|
||||
|
||||
## Prochaines étapes
|
||||
|
||||
- [Passerelle API](./gateway) — exposer vos fournisseurs comme serveur API local
|
||||
- [Démarrage rapide](./getting-started) — retourner au guide de démarrage rapide
|
||||
@@ -0,0 +1,147 @@
|
||||
# Configurer les fournisseurs
|
||||
|
||||
BoosApi se connecte simultanément à n'importe quel nombre de fournisseurs IA. Chaque fournisseur a ses propres clés API, liste de modèles et paramètres par défaut.
|
||||
|
||||
## Fournisseurs supportés
|
||||
|
||||
| Fournisseur | Modèles exemple |
|
||||
|------------|----------------|
|
||||
| **OpenAI** | GPT-4o, GPT-4, o3, o4-mini |
|
||||
| **Anthropic** | Claude 4 Sonnet, Claude 4 Opus, Claude 3.5 Sonnet |
|
||||
| **Google** | Gemini 2.5 Pro, Gemini 2.5 Flash, Gemini 2.0 |
|
||||
| **DeepSeek** | DeepSeek V3, DeepSeek R1 |
|
||||
| **Alibaba Cloud** | Série Qwen |
|
||||
| **Zhipu AI** | Série GLM |
|
||||
| **xAI** | Série Grok |
|
||||
| **API compatible OpenAI** | Ollama, vLLM, LiteLLM, relais tiers, etc. |
|
||||
|
||||
---
|
||||
|
||||
## Ajouter un fournisseur
|
||||
|
||||
1. Allez dans **Paramètres → Fournisseurs**.
|
||||
2. Cliquez sur le bouton **+** en bas à gauche.
|
||||
3. Remplissez les détails du fournisseur :
|
||||
|
||||
| Champ | Description |
|
||||
|-------|-------------|
|
||||
| **Nom** | Nom d'affichage pour la barre latérale (ex. *OpenAI*) |
|
||||
| **Type** | Type de fournisseur — détermine l'URL de base par défaut |
|
||||
| **Icône** | Icône optionnelle pour l'identification visuelle |
|
||||
| **Clé API** | La clé secrète du tableau de bord de votre fournisseur |
|
||||
| **URL de base** | Endpoint API (pré-rempli pour les types intégrés) |
|
||||
| **Chemin API** | Chemin de requête — par défaut `/v1/chat/completions` |
|
||||
|
||||
---
|
||||
|
||||
## Importer depuis un lien Web
|
||||
|
||||
Les sites de fournisseurs, tableaux de bord de services relais, plateformes de modèles privées ou pages de passerelle locale peuvent proposer un lien **Ouvrir dans BoosApi**. Lorsqu'un utilisateur clique dessus, le navigateur ouvre l'application de bureau BoosApi, BoosApi passe à **Paramètres → Fournisseurs**, affiche une boîte de confirmation et importe la configuration uniquement après confirmation.
|
||||
|
||||
### Parcours utilisateur
|
||||
|
||||
1. Installez et ouvrez une version d'BoosApi compatible avec les liens de fournisseur.
|
||||
2. Cliquez sur le lien **Ouvrir dans BoosApi** fourni par le fournisseur dans le navigateur.
|
||||
3. Vérifiez dans BoosApi le nom du fournisseur, l'URL de base, le type de fournisseur et le préfixe de la clé API.
|
||||
4. BoosApi réutilise un fournisseur existant avec le même couple **URL de base + type**. S'il n'existe pas, BoosApi en crée un nouveau et ajoute la clé API seulement si elle n'est pas déjà présente.
|
||||
|
||||
BoosApi ne valide pas automatiquement la clé et ne récupère pas automatiquement les modèles. Après l'import, cliquez sur **Récupérer les modèles** ou ajoutez des modèles manuellement.
|
||||
|
||||
### Format du lien
|
||||
|
||||
```text
|
||||
boosapi://providers?name=<name>&baseurl=<base-url>&apikey=<api-key>&type=<provider-type>
|
||||
```
|
||||
|
||||
Exemple :
|
||||
|
||||
```text
|
||||
boosapi://providers?name=OpenAI&baseurl=https%3A%2F%2Fapi.openai.com&apikey=sk-xxx&type=openai
|
||||
```
|
||||
|
||||
### Paramètres
|
||||
|
||||
| Paramètre | Obligatoire | Description |
|
||||
|-----------|-------------|-------------|
|
||||
| `name` | Oui | Nom affiché dans BoosApi, par exemple `OpenAI` ou `My Relay` |
|
||||
| `baseurl` | Oui | URL de base encodée. Seuls `http` et `https` sont acceptés ; query et hash sont refusés. |
|
||||
| `apikey` | Oui | Clé API à enregistrer dans BoosApi. BoosApi n'affiche qu'un préfixe dans la boîte de confirmation. |
|
||||
| `type` | Oui | Type de fournisseur. Valeurs autorisées : `openai`, `openai_responses`, `anthropic`, `gemini`, `custom`. |
|
||||
|
||||
`baseurl` peut utiliser le suffixe forcé existant d'BoosApi, par exemple `https://example.com!`. L'import par lien ne définit pas `api_path` ; BoosApi continue d'utiliser le chemin par défaut du type de fournisseur choisi.
|
||||
|
||||
### Configuration du site Web
|
||||
|
||||
Encodez toutes les valeurs dynamiques avec `encodeURIComponent` ou `URLSearchParams` :
|
||||
|
||||
```html
|
||||
<a id="open-boosapi" href="#">Ouvrir dans BoosApi</a>
|
||||
|
||||
<script>
|
||||
const provider = {
|
||||
name: 'My Relay',
|
||||
baseurl: 'https://api.example.com',
|
||||
apikey: 'sk-user-key',
|
||||
type: 'openai',
|
||||
};
|
||||
|
||||
const params = new URLSearchParams({
|
||||
name: provider.name,
|
||||
baseurl: provider.baseurl,
|
||||
apikey: provider.apikey,
|
||||
type: provider.type,
|
||||
});
|
||||
|
||||
document.getElementById('open-boosapi').href = `boosapi://providers?${params.toString()}`;
|
||||
</script>
|
||||
```
|
||||
|
||||
Si votre service permet de générer des clés API, créez le lien uniquement lorsque l'utilisateur est connecté et a explicitement choisi ou créé une clé.
|
||||
|
||||
::: warning Sécurité
|
||||
Une clé API dans une URL peut être visible dans l'historique du navigateur, les journaux, les extensions ou les outils d'analyse. Ne placez pas de vraies clés sur des pages publiques, du HTML statique ou des redirections tierces. Préférez générer le lien sur une page privée du compte après confirmation de l'utilisateur.
|
||||
:::
|
||||
|
||||
::: tip Test
|
||||
`boosapi://` est un protocole personnalisé enregistré par l'application de bureau installée. Exécuter uniquement le site Web ou le serveur de développement Vite n'enregistre pas ce protocole. Si le lien n'ouvre pas BoosApi, installez ou reconstruisez d'abord la dernière application de bureau BoosApi.
|
||||
:::
|
||||
|
||||
---
|
||||
|
||||
## Importer depuis CC Switch
|
||||
|
||||
BoosApi peut scanner les configurations fournisseur de CC Switch depuis Settings -> Providers. Vérifiez chaque candidat, sélectionnez les lignes importables, puis importez fournisseurs, Base URLs, clés API et listes de modèles. Les entrées OAuth-only ou sans clé réutilisable sont ignorées avec une raison visible.
|
||||
|
||||
## Corps de requête modèle avancé
|
||||
|
||||
Chaque modèle peut définir extra_body, un objet JSON ajouté à plat aux requêtes OpenAI-compatible Chat Completions. Il sert aux options propres aux fournisseurs comme enable_thinking. BoosApi valide le JSON et bloque l’écrasement de model, messages, stream, tools et des champs de sampling de base.
|
||||
|
||||
## Rotation de clés multiples
|
||||
|
||||
BoosApi supporte plusieurs clés API par fournisseur pour la distribution de charge et l'évitement des limites de débit. Cliquez sur **Ajouter une clé** dans le panneau de détails du fournisseur.
|
||||
|
||||
---
|
||||
|
||||
## Gestion des modèles
|
||||
|
||||
Cliquez sur **Récupérer les modèles** pour obtenir la liste complète des modèles disponibles depuis l'API du fournisseur. Vous pouvez également ajouter des IDs de modèles manuellement.
|
||||
|
||||
Chaque modèle peut avoir ses propres paramètres par défaut : température, tokens maximum, Top P, pénalité de fréquence, pénalité de présence.
|
||||
|
||||
---
|
||||
|
||||
## Endpoints personnalisés et locaux
|
||||
|
||||
### Ollama (modèles locaux)
|
||||
|
||||
1. Installez et démarrez [Ollama](https://ollama.com/).
|
||||
2. Dans BoosApi, créez un nouveau fournisseur avec le type **OpenAI**.
|
||||
3. Définissez l'**URL de base** à `http://localhost:11434`.
|
||||
4. Cliquez sur **Récupérer les modèles** pour découvrir les modèles téléchargés localement.
|
||||
|
||||
---
|
||||
|
||||
## Prochaines étapes
|
||||
|
||||
- [Serveurs MCP](./mcp) — connecter des outils externes pour étendre les capacités IA
|
||||
- [Passerelle API](./gateway) — exposer vos fournisseurs comme serveur API local
|
||||
@@ -0,0 +1,57 @@
|
||||
---
|
||||
layout: home
|
||||
title: "BoosApi — Client IA de bureau open-source & passerelle"
|
||||
titleTemplate: false
|
||||
|
||||
head:
|
||||
- - meta
|
||||
- name: description
|
||||
content: "BoosApi est un client IA de bureau gratuit et open-source avec chat multi-modèles, Agent, MCP, import ChatGPT/Cherry Studio/Kelivo, RAG local, sauvegarde S3/WebDAV et passerelle IA intégrée."
|
||||
|
||||
hero:
|
||||
name: BoosApi
|
||||
text: "Votre espace de travail IA de bureau"
|
||||
tagline: "Chat multi-modèles, Agent, outils MCP, passerelle API, imports, base de connaissances et sauvegardes dans un client local-first"
|
||||
image:
|
||||
src: /logo.png
|
||||
alt: BoosApi
|
||||
actions:
|
||||
- theme: brand
|
||||
text: "Démarrage rapide"
|
||||
link: /fr/guide/getting-started
|
||||
- theme: alt
|
||||
text: "Télécharger"
|
||||
link: /fr/download
|
||||
- theme: alt
|
||||
text: GitHub
|
||||
link: https://github.com/BoosApi-Desktop/BoosApi
|
||||
|
||||
features:
|
||||
- icon: robot
|
||||
title: "Chat et modèles"
|
||||
details: "Connectez OpenAI, Claude, Gemini, DeepSeek, Qwen et tout endpoint compatible OpenAI avec Base URL, API Path, headers et proxy."
|
||||
- icon: api
|
||||
title: "Configuration fournisseurs"
|
||||
details: "Utilisez les liens boosapi:// et l’import CC Switch pour importer des profils fournisseur après confirmation."
|
||||
- icon: thunderbolt
|
||||
title: "AI Agent"
|
||||
details: "Le modèle peut éditer des fichiers, exécuter des commandes et analyser du code dans un workflow contrôlé."
|
||||
- icon: edit
|
||||
title: "Rendu de contenu"
|
||||
details: "Rendu Markdown, code, tableaux, tâches et LaTeX dans les conversations streamées."
|
||||
- icon: search
|
||||
title: "Recherche et connaissances"
|
||||
details: "Tavily, Zhipu WebSearch, Bocha avec sources citées et génération de requêtes."
|
||||
- icon: cloud-server
|
||||
title: "Passerelle API"
|
||||
details: "Exposez OpenAI Chat Completions, OpenAI Responses, Claude natif et Gemini natif depuis l’app."
|
||||
- icon: book
|
||||
title: "Import et sauvegarde"
|
||||
details: "Importez ChatGPT, Cherry Studio et Kelivo avec aperçu, avertissements et gestion des doublons."
|
||||
- icon: lock
|
||||
title: "Bureau et sécurité"
|
||||
details: "État dans ~/.boosapi/, fichiers utilisateur dans ~/Documents/boosapi/, clés API protégées par AES-256."
|
||||
- icon: desktop
|
||||
title: "Bureau et sécurité"
|
||||
details: "État dans ~/.boosapi/, fichiers utilisateur dans ~/Documents/boosapi/, clés API protégées par AES-256."
|
||||
---
|
||||
Reference in New Issue
Block a user