From e7217bf2d2e94dde51a7481415f2a7be4de3f72a Mon Sep 17 00:00:00 2001 From: PhoenixCPH Date: Fri, 22 May 2026 02:28:48 +0800 Subject: [PATCH] docs: add multi-language README support Add Spanish, French, Portuguese, Russian, and German README translations under doc/, and extend the language switcher across all README variants to match Chatbox's global user base. --- README.md | 10 +- doc/README-CN.md | 10 +- doc/README-DE.md | 356 +++++++++++++++++++++++++++++++++++++++++++++++ doc/README-ES.md | 356 +++++++++++++++++++++++++++++++++++++++++++++++ doc/README-FR.md | 356 +++++++++++++++++++++++++++++++++++++++++++++++ doc/README-PT.md | 356 +++++++++++++++++++++++++++++++++++++++++++++++ doc/README-RU.md | 356 +++++++++++++++++++++++++++++++++++++++++++++++ 7 files changed, 1796 insertions(+), 4 deletions(-) create mode 100644 doc/README-DE.md create mode 100644 doc/README-ES.md create mode 100644 doc/README-FR.md create mode 100644 doc/README-PT.md create mode 100644 doc/README-RU.md diff --git a/README.md b/README.md index 90d85f186f..63130f35c1 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,12 @@

- English | - 简体中文 + Languages: + English · + 简体中文 · + Español · + Français · + Português · + Русский · + Deutsch

This is the repository for the Chatbox Community Edition, open-sourced under the GPLv3 license. diff --git a/doc/README-CN.md b/doc/README-CN.md index 1d7692e716..10be41fae9 100644 --- a/doc/README-CN.md +++ b/doc/README-CN.md @@ -1,6 +1,12 @@

- English | - 简体中文 + 语言 / Languages: + English · + 简体中文 · + Español · + Français · + Português · + Русский · + Deutsch

这里是 Chatbox 社区版的代码仓库,以 GPLv3 许可证开源。 diff --git a/doc/README-DE.md b/doc/README-DE.md new file mode 100644 index 0000000000..39987e61a8 --- /dev/null +++ b/doc/README-DE.md @@ -0,0 +1,356 @@ +

+ Sprachen / Languages: + English · + 简体中文 · + Español · + Français · + Português · + Русский · + Deutsch +

+ +Dies ist das Repository der Chatbox Community Edition, die unter der GPLv3-Lizenz als Open Source veröffentlicht ist. + +[Chatbox wird wieder Open Source!](https://github.com/chatboxai/chatbox/issues/2266) + +Wir synchronisieren regelmäßig Code vom Pro-Repository in dieses Repository und umgekehrt. + +### Download für Desktop + + + + + + + + + + + + + +
+ Windows + + MacOS + + Linux +
+ + +
+ Setup.exe +
+
+ + +
+ Intel +
+
+ + +
+ Apple Silicon +
+
+ + +
+ AppImage +
+
+ +### Download für iOS/Android + + + + + + + + + +.APK + + +Weitere Informationen: [chatboxai.app](https://chatboxai.app/) + +## Schnellstart + +### Für Endbenutzer +1. Laden Sie das passende Installationsprogramm für Ihre Plattform von der [Releases-Seite](https://github.com/chatboxai/chatbox/releases) herunter +2. Installieren und starten Sie Chatbox +3. Konfigurieren Sie Ihren KI-Anbieter (OpenAI, Claude usw.) in den Einstellungen +4. Beginnen Sie zu chatten! + +### Systemanforderungen + +| Plattform | Mindestversion | Architektur | +|----------|----------------|--------------| +| Windows | Windows 10 | x64 | +| macOS | macOS 11 (Big Sur) | Intel/Apple Silicon | +| Linux | Ubuntu 20.04+ / AppImage-fähige Distributionen | x64 | + +--- +
+ + Warp sponsorship + + +### [Warp, entwickelt für Programmieren mit mehreren KI-Agenten.](https://go.warp.dev/chatbox) +[Verfügbar für MacOS, Linux und Windows](https://go.warp.dev/chatbox)
+
+ +
+ +

+ + + Chatbox + (Community Edition) + +

+

+ Ihr ultimativer KI-Copilot auf dem Desktop.
Chatbox ist ein Desktop-Client für ChatGPT, Claude und andere LLMs, verfügbar für Windows, Mac und Linux
+

+ +

+ +macOS + + +Windows + + +Linux + + +Downloads + + +Privacy + +

+ +Chatbox - Better UI & Desktop App for ChatGPT, Claude and other LLMs. | Product Hunt + + + + + + + + + + +## Funktionen + +### 🤖 KI-Modell-Unterstützung +- **Unterstützung für mehrere LLM-Anbieter** + :gear: Nahtlose Integration mit einer Vielzahl modernster Sprachmodelle: + - OpenAI (ChatGPT) + - Azure OpenAI + - Claude + - Google Gemini Pro + - Ollama (Zugriff auf lokale Modelle wie llama2, Mistral, Mixtral, codellama, vicuna, yi und solar) + - ChatGLM-6B + +- **Bildgenerierung mit Dall-E-3** + :art: Erstellen Sie die Bilder Ihrer Vorstellung mit Dall-E-3. + +- **Erweiterte Prompts** + :speech_balloon: Erweiterte Prompting-Funktionen zur Verfeinerung und Fokussierung Ihrer Anfragen für bessere Antworten. + +### 🖥️ Benutzererfahrung +- **Lokale Datenspeicherung** + :floppy_disk: Ihre Daten bleiben auf Ihrem Gerät, sodass sie nie verloren gehen und Ihre Privatsphäre gewahrt bleibt. + +- **Installationspakete ohne Deployment** + :package: Schneller Einstieg mit herunterladbaren Installationspaketen. Keine komplexe Einrichtung nötig! + +- **Ergonomische Benutzeroberfläche und Dunkles Theme** + :new_moon: Eine benutzerfreundliche Oberfläche mit Nachtmodus-Option zur Reduzierung der Augenbelastung bei längerer Nutzung. + +- **Tastenkürzel** + :keyboard: Bleiben Sie produktiv mit Tastenkürzeln, die Ihren Workflow beschleunigen. + +- **Streaming-Antworten** + :arrow_forward: Schnelle Antworten auf Ihre Interaktionen mit sofortigen, progressiven Antworten. + +### 📄 Inhalt und Formatierung +- **Markdown, Latex und Code-Hervorhebung** + :scroll: Erstellen Sie Nachrichten mit der vollen Kraft der Markdown- und Latex-Formatierung, kombiniert mit Syntaxhervorhebung für verschiedene Programmiersprachen, um Lesbarkeit und Darstellung zu verbessern. + +- **Prompt-Bibliothek und Nachrichtenzitate** + :books: Speichern und organisieren Sie Prompts zur Wiederverwendung und zitieren Sie Nachrichten für Kontext in Diskussionen. + +### 👥 Zusammenarbeit und Teilen +- **Team-Zusammenarbeit** + :busts_in_silhouette: Arbeiten Sie mühelos zusammen und teilen Sie OpenAI-API-Ressourcen in Ihrem Team. [Mehr erfahren](../team-sharing/README.md) + +### 🌐 Plattformverfügbarkeit +- **Plattformübergreifender Desktop** + :computer: Chatbox ist bereit für Windows-, Mac- und Linux-Nutzer. + +- **Web-Version** + :globe_with_meridians: Nutzen Sie die Webanwendung auf jedem Gerät mit Browser, überall. + +- **Mobile Apps** + :phone: Native iOS- und Android-Anwendungen für den Zugriff unterwegs. + +### 🌍 Lokalisierung +- **Mehrsprachige Unterstützung** + :earth_americas: Für ein globales Publikum mit Unterstützung in mehreren Sprachen: + - English + - 简体中文 (Simplified Chinese) + - 繁體中文 (Traditional Chinese) + - 日本語 (Japanese) + - 한국어 (Korean) + - Français (French) + - Deutsch (German) + - Русский (Russian) + - Español (Spanish) + +### ✨ Weitere Funktionen +- **Und mehr...** + :sparkles: Ständige Verbesserung der Erfahrung mit neuen Funktionen! + +## FAQ + +- [Häufig gestellte Fragen](./FAQ.md) + +## Warum habe ich Chatbox entwickelt? + +Ich habe Chatbox ursprünglich entwickelt, weil ich einige Prompts debuggte und ein einfaches und benutzerfreundliches Tool für Prompt- und API-Debugging brauchte. Ich dachte, es könnte mehr Menschen geben, die ein solches Tool benötigen, also habe ich es als Open Source veröffentlicht. + +Anfangs wusste ich nicht, dass es so beliebt werden würde. Ich habe auf das Feedback der Open-Source-Community gehört und es weiterentwickelt und verbessert. Jetzt ist es zu einer sehr nützlichen KI-Desktop-Anwendung geworden. Es gibt viele Nutzer, die Chatbox lieben, und sie verwenden es nicht nur zum Entwickeln und Debuggen von Prompts, sondern auch für alltägliche Chats und sogar für interessantere Dinge, wie gut gestaltete Prompts zu verwenden, damit KI verschiedene professionelle Rollen spielt und sie bei der täglichen Arbeit unterstützt... + +## Wie man beiträgt + +Wir freuen uns über Beiträge aus der Community! So können Sie helfen, Chatbox besser zu machen: + +### 🐛 Fehler melden +- Verwenden Sie [GitHub Issues](https://github.com/chatboxai/chatbox/issues), um Fehler zu melden oder Funktionen anzufordern +- Bevor Sie ein neues Issue erstellen, suchen Sie bitte in bestehenden Issues, um Duplikate zu vermeiden +- Geben Sie detaillierte Informationen an, einschließlich Schritte zur Reproduktion, erwartetem Verhalten und Screenshots, falls zutreffend + +### 🔧 Pull Requests +1. Forken Sie das Repository und erstellen Sie Ihren Branch von `main` +2. Nehmen Sie Ihre Änderungen vor und stellen Sie sicher, dass der Code unseren Coding-Standards entspricht +3. Testen Sie Ihre Änderungen gründlich +4. Aktualisieren Sie die Dokumentation bei Bedarf +5. Reichen Sie einen Pull Request mit einer klaren Beschreibung der Änderungen ein + +### 🌍 Übersetzungen +Helfen Sie, Chatbox für mehr Menschen zugänglich zu machen, indem Sie Übersetzungen beisteuern: +- Übersetzungsdateien befinden sich im Verzeichnis `src/locales` +- Folgen Sie dem bestehenden Übersetzungsformat +- Reichen Sie einen PR mit Ihren Übersetzungsverbesserungen ein + +### 📖 Dokumentation +- Verbessern Sie README, API-Dokumentation oder Benutzerhandbücher +- Korrigieren Sie Tippfehler oder klären Sie unklare Anweisungen +- Fügen Sie Beispiele und Tutorials hinzu + +### 🌟 Andere Beitragsmöglichkeiten +- Geben Sie dem Repository einen Stern, um Ihre Unterstützung zu zeigen +- Teilen Sie Chatbox mit anderen +- Beantworten Sie Fragen in [GitHub Discussions](https://github.com/chatboxai/chatbox/discussions) +- Geben Sie Feedback und Vorschläge + +**Vielen Dank für Ihren Beitrag! 🙏** + +## Entwicklung + +### Voraussetzungen + +Bevor Sie beginnen, stellen Sie sicher, dass Folgendes installiert ist: + +- **Node.js** (v20.x – v22.x) - [Hier herunterladen](https://nodejs.org/) +- **pnpm** (v10.x oder höher) - Installieren via `corepack enable && corepack prepare pnpm@latest --activate` +- **Git** - [Hier herunterladen](https://git-scm.com/) + +### Schnelle Einrichtung + +1. **Repository klonen** + ```bash + git clone https://github.com/chatboxai/chatbox.git + cd chatbox + ``` + +2. **Abhängigkeiten installieren** + ```bash + pnpm install + ``` + +3. **Entwicklungsserver starten** + ```bash + pnpm run dev + ``` + Die Anwendung startet im Entwicklungsmodus mit aktiviertem Hot-Reload. + +### Build-Befehle + +| Befehl | Beschreibung | +|---------|-------------| +| `pnpm run dev` | Entwicklungsserver mit Hot-Reload starten | +| `pnpm run package` | Für aktuelle Plattform bauen und paketieren | +| `pnpm run package:all` | Für alle Plattformen bauen und paketieren | +| `pnpm run build` | Für Produktion bauen ohne Paketierung | +| `pnpm run lint` | Biome zur Code-Qualitätsprüfung ausführen | +| `pnpm run test` | Vitest-Testsuite ausführen | + +### Projektstruktur + +``` +chatbox/ +├── src/ +│ ├── main/ # Electron-Hauptprozess +│ ├── renderer/ # React-Renderer (UI) +│ ├── preload/ # Electron-Preload-Skripte +│ └── shared/ # Gemeinsame Utilities +├── doc/ # Dokumentation und Assets +├── resources/ # App-Ressourcen und Icons +├── team-sharing/ # Team-Kollaborationsfunktionen +└── package.json # Projektkonfiguration +``` + +### Entwicklungstipps + +- Verwenden Sie `pnpm run lint` vor dem Commit, um die Code-Qualität sicherzustellen +- Folgen Sie dem bestehenden Code-Stil und den Mustern +- Testen Sie Ihre Änderungen in hellen und dunklen Themes +- Stellen Sie plattformübergreifende Kompatibilität bei UI-Änderungen sicher + +### Fehlerbehebung + +**Problem**: `pnpm install` schlägt fehl +- **Lösung**: Stellen Sie sicher, dass Sie pnpm (nicht npm oder yarn) verwenden und die Node.js-Version im erforderlichen Bereich liegt. Führen Sie `corepack enable` aus, wenn pnpm nicht gefunden wird. + +**Problem**: Build schlägt unter Windows fehl +- **Lösung**: Führen Sie `pnpm config set script-shell "C:\\Program Files\\git\\bin\\bash.exe"` aus, wenn Sie Git Bash verwenden + +**Problem**: Änderungen werden in der Entwicklung nicht angezeigt +- **Lösung**: Stoppen Sie den Dev-Server, löschen Sie `node_modules/.vite` und starten Sie neu + +## Star History + +[![Star History Chart](https://api.star-history.com/svg?repos=chatboxai/chatbox&type=Date)](https://star-history.com/#chatboxai/chatbox&Date) + +## Kontakt + +[Twitter](https://x.com/ChatboxAI_HQ) | [Email](mailto:hi@chatboxai.com) + +## Lizenz + +[LICENSE](../LICENSE) diff --git a/doc/README-ES.md b/doc/README-ES.md new file mode 100644 index 0000000000..e08f37d5f0 --- /dev/null +++ b/doc/README-ES.md @@ -0,0 +1,356 @@ +

+ Idiomas / Languages: + English · + 简体中文 · + Español · + Français · + Português · + Русский · + Deutsch +

+ +Este es el repositorio de Chatbox Community Edition, de código abierto bajo la licencia GPLv3. + +[¡Chatbox vuelve a ser de código abierto!](https://github.com/chatboxai/chatbox/issues/2266) + +Sincronizamos periódicamente el código del repositorio pro a este repositorio, y viceversa. + +### Descargar para escritorio + + + + + + + + + + + + + +
+ Windows + + MacOS + + Linux +
+ + +
+ Setup.exe +
+
+ + +
+ Intel +
+
+ + +
+ Apple Silicon +
+
+ + +
+ AppImage +
+
+ +### Descargar para iOS/Android + + + + + + + + + +.APK + + +Para más información: [chatboxai.app](https://chatboxai.app/) + +## Inicio rápido + +### Para usuarios finales +1. Descarga el instalador adecuado para tu plataforma desde la [página de releases](https://github.com/chatboxai/chatbox/releases) +2. Instala y abre Chatbox +3. Configura tu proveedor de IA (OpenAI, Claude, etc.) en los ajustes +4. ¡Empieza a chatear! + +### Requisitos del sistema + +| Plataforma | Versión mínima | Arquitectura | +|----------|----------------|--------------| +| Windows | Windows 10 | x64 | +| macOS | macOS 11 (Big Sur) | Intel/Apple Silicon | +| Linux | Ubuntu 20.04+ / distros compatibles con AppImage | x64 | + +--- +
+ + Warp sponsorship + + +### [Warp, diseñado para programar con múltiples agentes de IA.](https://go.warp.dev/chatbox) +[Disponible para MacOS, Linux y Windows](https://go.warp.dev/chatbox)
+
+ +
+ +

+ + + Chatbox + (Community Edition) + +

+

+ Tu copiloto de IA definitivo en el escritorio.
Chatbox es un cliente de escritorio para ChatGPT, Claude y otros LLM, disponible en Windows, Mac y Linux
+

+ +

+ +macOS + + +Windows + + +Linux + + +Downloads + + +Privacy + +

+ +Chatbox - Better UI & Desktop App for ChatGPT, Claude and other LLMs. | Product Hunt + + + + + + + + + + +## Características + +### 🤖 Compatibilidad con modelos de IA +- **Compatibilidad con múltiples proveedores de LLM** + :gear: Integración fluida con una variedad de modelos de lenguaje de vanguardia: + - OpenAI (ChatGPT) + - Azure OpenAI + - Claude + - Google Gemini Pro + - Ollama (permite acceder a modelos locales como llama2, Mistral, Mixtral, codellama, vicuna, yi y solar) + - ChatGLM-6B + +- **Generación de imágenes con Dall-E-3** + :art: Crea las imágenes de tu imaginación con Dall-E-3. + +- **Prompts mejorados** + :speech_balloon: Funciones avanzadas de prompting para refinar y enfocar tus consultas y obtener mejores respuestas. + +### 🖥️ Experiencia de usuario +- **Almacenamiento local de datos** + :floppy_disk: Tus datos permanecen en tu dispositivo, garantizando que nunca se pierdan y protegiendo tu privacidad. + +- **Paquetes de instalación sin despliegue** + :package: Empieza rápidamente con paquetes de instalación descargables. ¡No se necesita una configuración compleja! + +- **Interfaz ergonómica y tema oscuro** + :new_moon: Una interfaz fácil de usar con modo nocturno para reducir la fatiga visual durante el uso prolongado. + +- **Atajos de teclado** + :keyboard: Mantén la productividad con atajos que aceleran tu flujo de trabajo. + +- **Respuestas en streaming** + :arrow_forward: Proporciona respuestas rápidas a tus interacciones con respuestas inmediatas y progresivas. + +### 📄 Contenido y formato +- **Markdown, Latex y resaltado de código** + :scroll: Genera mensajes con toda la potencia del formato Markdown y Latex, junto con resaltado de sintaxis para varios lenguajes de programación, mejorando la legibilidad y la presentación. + +- **Biblioteca de prompts y citas de mensajes** + :books: Guarda y organiza prompts para reutilizarlos, y cita mensajes para dar contexto en las conversaciones. + +### 👥 Colaboración y compartición +- **Colaboración en equipo** + :busts_in_silhouette: Colabora con facilidad y comparte recursos de la API de OpenAI con tu equipo. [Más información](../team-sharing/README.md) + +### 🌐 Disponibilidad multiplataforma +- **Escritorio multiplataforma** + :computer: Chatbox está disponible para usuarios de Windows, Mac y Linux. + +- **Versión web** + :globe_with_meridians: Usa la aplicación web en cualquier dispositivo con navegador, en cualquier lugar. + +- **Aplicaciones móviles** + :phone: Aplicaciones nativas para iOS y Android para acceder sobre la marcha. + +### 🌍 Localización +- **Compatibilidad multilingüe** + :earth_americas: Atendiendo a una audiencia global con soporte en varios idiomas: + - English + - 简体中文 (Simplified Chinese) + - 繁體中文 (Traditional Chinese) + - 日本語 (Japanese) + - 한국어 (Korean) + - Français (French) + - Deutsch (German) + - Русский (Russian) + - Español (Spanish) + +### ✨ Más funciones +- **Y más...** + :sparkles: Mejoramos constantemente la experiencia con nuevas funciones. + +## FAQ + +- [Preguntas frecuentes](./FAQ.md) + +## ¿Por qué creé Chatbox? + +Desarrollé Chatbox inicialmente porque estaba depurando algunos prompts y necesitaba una herramienta sencilla y fácil de usar para depurar prompts y APIs. Pensé que podría haber más personas que necesitaran una herramienta así, así que lo publiqué como código abierto. + +Al principio, no sabía que sería tan popular. Escuché los comentarios de la comunidad de código abierto y continué desarrollándolo y mejorándolo. Ahora se ha convertido en una aplicación de escritorio de IA muy útil. Hay muchos usuarios que aman Chatbox, y no solo lo usan para desarrollar y depurar prompts, sino también para chatear a diario e incluso para hacer cosas más interesantes, como usar prompts bien diseñados para que la IA desempeñe diversos roles profesionales y les ayude en el trabajo cotidiano... + +## Cómo contribuir + +¡Damos la bienvenida a las contribuciones de la comunidad! Así puedes ayudar a mejorar Chatbox: + +### 🐛 Informar de problemas +- Usa [GitHub Issues](https://github.com/chatboxai/chatbox/issues) para informar de errores o solicitar funciones +- Antes de crear un nuevo issue, busca en los existentes para evitar duplicados +- Proporciona información detallada, incluidos los pasos para reproducir el problema, el comportamiento esperado y capturas de pantalla si procede + +### 🔧 Pull requests +1. Haz fork del repositorio y crea tu rama desde `main` +2. Realiza tus cambios y asegúrate de que el código sigue nuestros estándares +3. Prueba tus cambios a fondo +4. Actualiza la documentación si es necesario +5. Envía un pull request con una descripción clara de los cambios + +### 🌍 Traducciones +Ayuda a que Chatbox sea accesible para más personas contribuyendo con traducciones: +- Los archivos de traducción están en el directorio `src/locales` +- Sigue el formato de traducción existente +- Envía un PR con tus mejoras de traducción + +### 📖 Documentación +- Mejora el README, la documentación de la API o las guías de usuario +- Corrige erratas o aclara instrucciones poco claras +- Añade ejemplos y tutoriales + +### 🌟 Otras formas de contribuir +- Dale una estrella al repositorio para mostrar tu apoyo +- Comparte Chatbox con otras personas +- Responde preguntas en [GitHub Discussions](https://github.com/chatboxai/chatbox/discussions) +- Proporciona comentarios y sugerencias + +**¡Gracias por contribuir! 🙏** + +## Desarrollo + +### Requisitos previos + +Antes de empezar, asegúrate de tener instalado lo siguiente: + +- **Node.js** (v20.x – v22.x) - [Descargar aquí](https://nodejs.org/) +- **pnpm** (v10.x o posterior) - Instalar con `corepack enable && corepack prepare pnpm@latest --activate` +- **Git** - [Descargar aquí](https://git-scm.com/) + +### Configuración rápida + +1. **Clona el repositorio** + ```bash + git clone https://github.com/chatboxai/chatbox.git + cd chatbox + ``` + +2. **Instala las dependencias** + ```bash + pnpm install + ``` + +3. **Inicia el servidor de desarrollo** + ```bash + pnpm run dev + ``` + La aplicación se iniciará en modo de desarrollo con recarga en caliente habilitada. + +### Comandos de compilación + +| Comando | Descripción | +|---------|-------------| +| `pnpm run dev` | Inicia el servidor de desarrollo con recarga en caliente | +| `pnpm run package` | Compila y empaqueta para la plataforma actual | +| `pnpm run package:all` | Compila y empaqueta para todas las plataformas | +| `pnpm run build` | Compila para producción sin empaquetar | +| `pnpm run lint` | Ejecuta Biome para comprobar la calidad del código | +| `pnpm run test` | Ejecuta la suite de pruebas de Vitest | + +### Estructura del proyecto + +``` +chatbox/ +├── src/ +│ ├── main/ # Proceso principal de Electron +│ ├── renderer/ # Renderer de React (UI) +│ ├── preload/ # Scripts preload de Electron +│ └── shared/ # Utilidades compartidas +├── doc/ # Documentación y recursos +├── resources/ # Recursos e iconos de la app +├── team-sharing/ # Funciones de colaboración en equipo +└── package.json # Configuración del proyecto +``` + +### Consejos de desarrollo + +- Usa `pnpm run lint` antes de hacer commit para garantizar la calidad del código +- Sigue el estilo de código y los patrones existentes +- Prueba tus cambios en los temas claro y oscuro +- Asegura la compatibilidad multiplataforma al modificar la interfaz + +### Solución de problemas + +**Problema**: `pnpm install` falla +- **Solución**: Asegúrate de usar pnpm (no npm ni yarn) y de que la versión de Node.js esté dentro del rango requerido. Ejecuta `corepack enable` si no se encuentra pnpm. + +**Problema**: La compilación falla en Windows +- **Solución**: Ejecuta `pnpm config set script-shell "C:\\Program Files\\git\\bin\\bash.exe"` si usas Git Bash + +**Problema**: Los cambios no se reflejan en desarrollo +- **Solución**: Detén el servidor de desarrollo, elimina `node_modules/.vite` y reinicia + +## Star History + +[![Star History Chart](https://api.star-history.com/svg?repos=chatboxai/chatbox&type=Date)](https://star-history.com/#chatboxai/chatbox&Date) + +## Contacto + +[Twitter](https://x.com/ChatboxAI_HQ) | [Email](mailto:hi@chatboxai.com) + +## Licencia + +[LICENSE](../LICENSE) diff --git a/doc/README-FR.md b/doc/README-FR.md new file mode 100644 index 0000000000..3c803bc1fd --- /dev/null +++ b/doc/README-FR.md @@ -0,0 +1,356 @@ +

+ Langues / Languages: + English · + 简体中文 · + Español · + Français · + Português · + Русский · + Deutsch +

+ +Voici le dépôt de Chatbox Community Edition, publié en open source sous la licence GPLv3. + +[Chatbox redevient open source !](https://github.com/chatboxai/chatbox/issues/2266) + +Nous synchronisons régulièrement le code du dépôt pro vers ce dépôt, et inversement. + +### Télécharger pour ordinateur + + + + + + + + + + + + + +
+ Windows + + MacOS + + Linux +
+ + +
+ Setup.exe +
+
+ + +
+ Intel +
+
+ + +
+ Apple Silicon +
+
+ + +
+ AppImage +
+
+ +### Télécharger pour iOS/Android + + + + + + + + + +.APK + + +Pour plus d'informations : [chatboxai.app](https://chatboxai.app/) + +## Démarrage rapide + +### Pour les utilisateurs finaux +1. Téléchargez l'installateur adapté à votre plateforme depuis la [page des releases](https://github.com/chatboxai/chatbox/releases) +2. Installez et lancez Chatbox +3. Configurez votre fournisseur d'IA (OpenAI, Claude, etc.) dans les paramètres +4. Commencez à discuter ! + +### Configuration requise + +| Plateforme | Version minimale | Architecture | +|----------|----------------|--------------| +| Windows | Windows 10 | x64 | +| macOS | macOS 11 (Big Sur) | Intel/Apple Silicon | +| Linux | Ubuntu 20.04+ / distributions compatibles AppImage | x64 | + +--- +
+ + Warp sponsorship + + +### [Warp, conçu pour coder avec plusieurs agents IA.](https://go.warp.dev/chatbox) +[Disponible pour MacOS, Linux et Windows](https://go.warp.dev/chatbox)
+
+ +
+ +

+ + + Chatbox + (Community Edition) + +

+

+ Votre copilote IA ultime sur le bureau.
Chatbox est un client de bureau pour ChatGPT, Claude et d'autres LLM, disponible sur Windows, Mac et Linux
+

+ +

+ +macOS + + +Windows + + +Linux + + +Downloads + + +Privacy + +

+ +Chatbox - Better UI & Desktop App for ChatGPT, Claude and other LLMs. | Product Hunt + + + + + + + + + + +## Fonctionnalités + +### 🤖 Prise en charge des modèles d'IA +- **Prise en charge de plusieurs fournisseurs de LLM** + :gear: Intégration transparente avec une variété de modèles de langage de pointe : + - OpenAI (ChatGPT) + - Azure OpenAI + - Claude + - Google Gemini Pro + - Ollama (permet d'accéder à des modèles locaux comme llama2, Mistral, Mixtral, codellama, vicuna, yi et solar) + - ChatGLM-6B + +- **Génération d'images avec Dall-E-3** + :art: Créez les images de votre imagination avec Dall-E-3. + +- **Prompts améliorés** + :speech_balloon: Fonctionnalités avancées de prompting pour affiner et cibler vos requêtes afin d'obtenir de meilleures réponses. + +### 🖥️ Expérience utilisateur +- **Stockage local des données** + :floppy_disk: Vos données restent sur votre appareil, garantissant qu'elles ne seront jamais perdues et préservant votre confidentialité. + +- **Paquets d'installation sans déploiement** + :package: Démarrez rapidement avec des paquets d'installation téléchargeables. Aucune configuration complexe nécessaire ! + +- **Interface ergonomique et thème sombre** + :new_moon: Une interface conviviale avec un mode nuit pour réduire la fatigue oculaire lors d'une utilisation prolongée. + +- **Raccourcis clavier** + :keyboard: Restez productif grâce à des raccourcis qui accélèrent votre flux de travail. + +- **Réponses en streaming** + :arrow_forward: Fournissez des réponses rapides à vos interactions avec des réponses immédiates et progressives. + +### 📄 Contenu et mise en forme +- **Markdown, Latex et coloration syntaxique** + :scroll: Générez des messages avec toute la puissance du formatage Markdown et Latex, associée à la coloration syntaxique pour divers langages de programmation, améliorant la lisibilité et la présentation. + +- **Bibliothèque de prompts et citation de messages** + :books: Enregistrez et organisez des prompts pour les réutiliser, et citez des messages pour le contexte dans les discussions. + +### 👥 Collaboration et partage +- **Collaboration en équipe** + :busts_in_silhouette: Collaborez facilement et partagez les ressources de l'API OpenAI au sein de votre équipe. [En savoir plus](../team-sharing/README.md) + +### 🌐 Disponibilité multiplateforme +- **Bureau multiplateforme** + :computer: Chatbox est disponible pour les utilisateurs de Windows, Mac et Linux. + +- **Version web** + :globe_with_meridians: Utilisez l'application web sur n'importe quel appareil doté d'un navigateur, où que vous soyez. + +- **Applications mobiles** + :phone: Applications natives iOS et Android pour un accès nomade. + +### 🌍 Localisation +- **Prise en charge multilingue** + :earth_americas: Répondant aux besoins d'un public mondial en proposant un support dans plusieurs langues : + - English + - 简体中文 (Simplified Chinese) + - 繁體中文 (Traditional Chinese) + - 日本語 (Japanese) + - 한국어 (Korean) + - Français (French) + - Deutsch (German) + - Русский (Russian) + - Español (Spanish) + +### ✨ Plus de fonctionnalités +- **Et plus encore...** + :sparkles: Amélioration constante de l'expérience avec de nouvelles fonctionnalités ! + +## FAQ + +- [Questions fréquemment posées](./FAQ.md) + +## Pourquoi j'ai créé Chatbox ? + +J'ai développé Chatbox initialement parce que je déboguais certains prompts et avais besoin d'un outil simple et facile à utiliser pour déboguer les prompts et les API. J'ai pensé qu'il pourrait y avoir d'autres personnes ayant besoin d'un tel outil, alors je l'ai publié en open source. + +Au début, je ne savais pas que ce serait si populaire. J'ai écouté les retours de la communauté open source et j'ai continué à le développer et à l'améliorer. Aujourd'hui, c'est devenu une application de bureau IA très utile. De nombreux utilisateurs adorent Chatbox, et ils ne l'utilisent pas seulement pour développer et déboguer des prompts, mais aussi pour discuter au quotidien, et même pour faire des choses plus intéressantes, comme utiliser des prompts bien conçus pour faire jouer à l'IA divers rôles professionnels afin de les aider dans leur travail quotidien... + +## Comment contribuer + +Nous accueillons les contributions de la communauté ! Voici comment vous pouvez aider à améliorer Chatbox : + +### 🐛 Signaler des problèmes +- Utilisez [GitHub Issues](https://github.com/chatboxai/chatbox/issues) pour signaler des bugs ou demander des fonctionnalités +- Avant de créer un nouveau ticket, veuillez rechercher les tickets existants pour éviter les doublons +- Fournissez des informations détaillées, y compris les étapes de reproduction, le comportement attendu et des captures d'écran le cas échéant + +### 🔧 Pull requests +1. Forkez le dépôt et créez votre branche à partir de `main` +2. Apportez vos modifications et assurez-vous que le code respecte nos standards +3. Testez vos modifications en profondeur +4. Mettez à jour la documentation si nécessaire +5. Soumettez une pull request avec une description claire des changements + +### 🌍 Traductions +Aidez à rendre Chatbox accessible à davantage de personnes en contribuant aux traductions : +- Les fichiers de traduction se trouvent dans le répertoire `src/locales` +- Suivez le format de traduction existant +- Soumettez une PR avec vos améliorations de traduction + +### 📖 Documentation +- Améliorez le README, la documentation API ou les guides utilisateur +- Corrigez les fautes de frappe ou clarifiez les instructions peu claires +- Ajoutez des exemples et des tutoriels + +### 🌟 Autres façons de contribuer +- Mettez une étoile au dépôt pour montrer votre soutien +- Partagez Chatbox avec d'autres personnes +- Répondez aux questions dans [GitHub Discussions](https://github.com/chatboxai/chatbox/discussions) +- Fournissez des retours et des suggestions + +**Merci pour votre contribution ! 🙏** + +## Développement + +### Prérequis + +Avant de commencer, assurez-vous d'avoir installé les éléments suivants : + +- **Node.js** (v20.x – v22.x) - [Télécharger ici](https://nodejs.org/) +- **pnpm** (v10.x ou ultérieur) - Installer via `corepack enable && corepack prepare pnpm@latest --activate` +- **Git** - [Télécharger ici](https://git-scm.com/) + +### Configuration rapide + +1. **Clonez le dépôt** + ```bash + git clone https://github.com/chatboxai/chatbox.git + cd chatbox + ``` + +2. **Installez les dépendances** + ```bash + pnpm install + ``` + +3. **Démarrez le serveur de développement** + ```bash + pnpm run dev + ``` + L'application démarrera en mode développement avec le rechargement à chaud activé. + +### Commandes de build + +| Commande | Description | +|---------|-------------| +| `pnpm run dev` | Démarre le serveur de développement avec rechargement à chaud | +| `pnpm run package` | Compile et empaquette pour la plateforme actuelle | +| `pnpm run package:all` | Compile et empaquette pour toutes les plateformes | +| `pnpm run build` | Compile pour la production sans empaquetage | +| `pnpm run lint` | Exécute Biome pour vérifier la qualité du code | +| `pnpm run test` | Exécute la suite de tests Vitest | + +### Structure du projet + +``` +chatbox/ +├── src/ +│ ├── main/ # Processus principal Electron +│ ├── renderer/ # Renderer React (UI) +│ ├── preload/ # Scripts preload Electron +│ └── shared/ # Utilitaires partagés +├── doc/ # Documentation et ressources +├── resources/ # Ressources et icônes de l'app +├── team-sharing/ # Fonctionnalités de collaboration en équipe +└── package.json # Configuration du projet +``` + +### Conseils de développement + +- Utilisez `pnpm run lint` avant de committer pour garantir la qualité du code +- Suivez le style de code et les modèles existants +- Testez vos modifications sur les thèmes clair et sombre +- Assurez la compatibilité multiplateforme lors des modifications de l'interface + +### Dépannage + +**Problème** : `pnpm install` échoue +- **Solution** : Assurez-vous d'utiliser pnpm (et non npm ou yarn) et que la version de Node.js est dans la plage requise. Exécutez `corepack enable` si pnpm n'est pas trouvé. + +**Problème** : Le build échoue sur Windows +- **Solution** : Exécutez `pnpm config set script-shell "C:\\Program Files\\git\\bin\\bash.exe"` si vous utilisez Git Bash + +**Problème** : Les modifications ne se reflètent pas en développement +- **Solution** : Arrêtez le serveur de développement, supprimez `node_modules/.vite` et redémarrez + +## Star History + +[![Star History Chart](https://api.star-history.com/svg?repos=chatboxai/chatbox&type=Date)](https://star-history.com/#chatboxai/chatbox&Date) + +## Contact + +[Twitter](https://x.com/ChatboxAI_HQ) | [Email](mailto:hi@chatboxai.com) + +## Licence + +[LICENSE](../LICENSE) diff --git a/doc/README-PT.md b/doc/README-PT.md new file mode 100644 index 0000000000..a8bcf99a64 --- /dev/null +++ b/doc/README-PT.md @@ -0,0 +1,356 @@ +

+ Idiomas / Languages: + English · + 简体中文 · + Español · + Français · + Português · + Русский · + Deutsch +

+ +Este é o repositório da Chatbox Community Edition, de código aberto sob a licença GPLv3. + +[Chatbox está voltando a ser open-source!](https://github.com/chatboxai/chatbox/issues/2266) + +Sincronizamos regularmente o código do repositório pro para este repositório, e vice-versa. + +### Download para Desktop + + + + + + + + + + + + + +
+ Windows + + MacOS + + Linux +
+ + +
+ Setup.exe +
+
+ + +
+ Intel +
+
+ + +
+ Apple Silicon +
+
+ + +
+ AppImage +
+
+ +### Download para iOS/Android + + + + + + + + + +.APK + + +Para mais informações: [chatboxai.app](https://chatboxai.app/) + +## Início Rápido + +### Para Usuários Finais +1. Baixe o instalador adequado para a sua plataforma na [página de releases](https://github.com/chatboxai/chatbox/releases) +2. Instale e inicie o Chatbox +3. Configure seu provedor de IA (OpenAI, Claude, etc.) nas configurações +4. Comece a conversar! + +### Requisitos do Sistema + +| Plataforma | Versão Mínima | Arquitetura | +|----------|----------------|--------------| +| Windows | Windows 10 | x64 | +| macOS | macOS 11 (Big Sur) | Intel/Apple Silicon | +| Linux | Ubuntu 20.04+ / distros compatíveis com AppImage | x64 | + +--- +
+ + Warp sponsorship + + +### [Warp, feito para programar com múltiplos agentes de IA.](https://go.warp.dev/chatbox) +[Disponível para MacOS, Linux e Windows](https://go.warp.dev/chatbox)
+
+ +
+ +

+ + + Chatbox + (Community Edition) + +

+

+ Seu Copiloto de IA Definitivo no Desktop.
Chatbox é um cliente desktop para ChatGPT, Claude e outros LLMs, disponível no Windows, Mac e Linux
+

+ +

+ +macOS + + +Windows + + +Linux + + +Downloads + + +Privacy + +

+ +Chatbox - Better UI & Desktop App for ChatGPT, Claude and other LLMs. | Product Hunt + + + + + + + + + + +## Recursos + +### 🤖 Suporte a Modelos de IA +- **Suporte a Múltiplos Provedores de LLM** + :gear: Integre-se perfeitamente com uma variedade de modelos de linguagem de ponta: + - OpenAI (ChatGPT) + - Azure OpenAI + - Claude + - Google Gemini Pro + - Ollama (permite acesso a modelos locais como llama2, Mistral, Mixtral, codellama, vicuna, yi e solar) + - ChatGLM-6B + +- **Geração de Imagens com Dall-E-3** + :art: Crie as imagens da sua imaginação com Dall-E-3. + +- **Prompts Aprimorados** + :speech_balloon: Recursos avançados de prompting para refinar e focar suas consultas e obter melhores respostas. + +### 🖥️ Experiência do Usuário +- **Armazenamento Local de Dados** + :floppy_disk: Seus dados permanecem no seu dispositivo, garantindo que nunca se percam e mantendo sua privacidade. + +- **Pacotes de Instalação sem Implantação** + :package: Comece rapidamente com pacotes de instalação para download. Sem configuração complexa! + +- **Interface Ergonômica e Tema Escuro** + :new_moon: Uma interface amigável com opção de modo noturno para reduzir o cansaço visual durante o uso prolongado. + +- **Atalhos de Teclado** + :keyboard: Mantenha a produtividade com atalhos que aceleram seu fluxo de trabalho. + +- **Resposta em Streaming** + :arrow_forward: Forneça respostas rápidas às suas interações com respostas imediatas e progressivas. + +### 📄 Conteúdo e Formatação +- **Markdown, Latex e Destaque de Código** + :scroll: Gere mensagens com todo o poder da formatação Markdown e Latex, combinados com destaque de sintaxe para várias linguagens de programação, melhorando a legibilidade e a apresentação. + +- **Biblioteca de Prompts e Citação de Mensagens** + :books: Salve e organize prompts para reutilização, e cite mensagens para contexto em discussões. + +### 👥 Colaboração e Compartilhamento +- **Colaboração em Equipe** + :busts_in_silhouette: Colabore com facilidade e compartilhe recursos da API OpenAI com sua equipe. [Saiba Mais](../team-sharing/README.md) + +### 🌐 Disponibilidade de Plataforma +- **Desktop Multiplataforma** + :computer: Chatbox está pronto para usuários de Windows, Mac e Linux. + +- **Versão Web** + :globe_with_meridians: Use o aplicativo web em qualquer dispositivo com navegador, em qualquer lugar. + +- **Aplicativos Mobile** + :phone: Aplicativos nativos para iOS e Android para acesso em movimento. + +### 🌍 Localização +- **Suporte Multilíngue** + :earth_americas: Atendendo a um público global com suporte em vários idiomas: + - English + - 简体中文 (Simplified Chinese) + - 繁體中文 (Traditional Chinese) + - 日本語 (Japanese) + - 한국어 (Korean) + - Français (French) + - Deutsch (German) + - Русский (Russian) + - Español (Spanish) + +### ✨ Mais Recursos +- **E Mais...** + :sparkles: Melhorando constantemente a experiência com novos recursos! + +## Perguntas Frequentes + +- [Perguntas Frequentes](./FAQ.md) + +## Por que criei o Chatbox? + +Desenvolvi o Chatbox inicialmente porque estava depurando alguns prompts e senti a necessidade de uma ferramenta simples e fácil de usar para depuração de prompts e APIs. Achei que poderia haver mais pessoas que precisassem de uma ferramenta assim, então o tornei open-source. + +No início, não sabia que seria tão popular. Ouço o feedback da comunidade open-source e continuo desenvolvendo e melhorando. Agora, tornou-se um aplicativo de desktop de IA muito útil. Há muitos usuários que adoram o Chatbox, e eles não o usam apenas para desenvolver e depurar prompts, mas também para conversas do dia a dia, e até para fazer coisas mais interessantes, como usar prompts bem elaborados para fazer a IA assumir vários papéis profissionais e ajudá-los no trabalho cotidiano... + +## Como Contribuir + +Acolhemos contribuições da comunidade! Veja como você pode ajudar a tornar o Chatbox ainda melhor: + +### 🐛 Reportar Problemas +- Use [GitHub Issues](https://github.com/chatboxai/chatbox/issues) para reportar bugs ou solicitar recursos +- Antes de criar uma nova issue, pesquise as issues existentes para evitar duplicatas +- Forneça informações detalhadas, incluindo passos para reproduzir, comportamento esperado e capturas de tela, se aplicável + +### 🔧 Pull Requests +1. Faça fork do repositório e crie sua branch a partir de `main` +2. Faça suas alterações e garanta que o código siga nossos padrões de codificação +3. Teste suas alterações minuciosamente +4. Atualize a documentação, se necessário +5. Envie um pull request com uma descrição clara das alterações + +### 🌍 Traduções +Ajude a tornar o Chatbox acessível a mais pessoas contribuindo com traduções: +- Os arquivos de tradução estão localizados no diretório `src/locales` +- Siga o formato de tradução existente +- Envie um PR com suas melhorias de tradução + +### 📖 Documentação +- Melhore o README, a documentação da API ou os guias do usuário +- Corrija erros de digitação ou esclareça instruções pouco claras +- Adicione exemplos e tutoriais + +### 🌟 Outras Formas de Contribuir +- Dê uma estrela ao repositório para mostrar seu apoio +- Compartilhe o Chatbox com outras pessoas +- Responda perguntas em [GitHub Discussions](https://github.com/chatboxai/chatbox/discussions) +- Forneça feedback e sugestões + +**Obrigado por contribuir! 🙏** + +## Desenvolvimento + +### Pré-requisitos + +Antes de começar, certifique-se de ter o seguinte instalado: + +- **Node.js** (v20.x – v22.x) - [Download aqui](https://nodejs.org/) +- **pnpm** (v10.x ou posterior) - Instale via `corepack enable && corepack prepare pnpm@latest --activate` +- **Git** - [Download aqui](https://git-scm.com/) + +### Configuração Rápida + +1. **Clone o repositório** + ```bash + git clone https://github.com/chatboxai/chatbox.git + cd chatbox + ``` + +2. **Instale as dependências** + ```bash + pnpm install + ``` + +3. **Inicie o servidor de desenvolvimento** + ```bash + pnpm run dev + ``` + O aplicativo será iniciado em modo de desenvolvimento com hot-reload habilitado. + +### Comandos de Build + +| Comando | Descrição | +|---------|-------------| +| `pnpm run dev` | Inicia o servidor de desenvolvimento com hot-reload | +| `pnpm run package` | Compila e empacota para a plataforma atual | +| `pnpm run package:all` | Compila e empacota para todas as plataformas | +| `pnpm run build` | Compila para produção sem empacotamento | +| `pnpm run lint` | Executa o Biome para verificar a qualidade do código | +| `pnpm run test` | Executa a suíte de testes Vitest | + +### Estrutura do Projeto + +``` +chatbox/ +├── src/ +│ ├── main/ # Processo principal do Electron +│ ├── renderer/ # Renderer React (UI) +│ ├── preload/ # Scripts preload do Electron +│ └── shared/ # Utilitários compartilhados +├── doc/ # Documentação e assets +├── resources/ # Recursos e ícones do app +├── team-sharing/ # Recursos de colaboração em equipe +└── package.json # Configuração do projeto +``` + +### Dicas de Desenvolvimento + +- Use `pnpm run lint` antes de fazer commit para garantir a qualidade do código +- Siga o estilo de código e os padrões existentes +- Teste suas alterações nos temas claro e escuro +- Garanta compatibilidade multiplataforma ao fazer alterações na UI + +### Solução de Problemas + +**Problema**: `pnpm install` falha +- **Solução**: Certifique-se de estar usando pnpm (não npm ou yarn) e que a versão do Node.js está dentro da faixa exigida. Execute `corepack enable` se o pnpm não for encontrado. + +**Problema**: Build falha no Windows +- **Solução**: Execute `pnpm config set script-shell "C:\\Program Files\\git\\bin\\bash.exe"` se estiver usando Git Bash + +**Problema**: Alterações não refletem no desenvolvimento +- **Solução**: Pare o servidor de desenvolvimento, exclua `node_modules/.vite` e reinicie + +## Histórico de Estrelas + +[![Star History Chart](https://api.star-history.com/svg?repos=chatboxai/chatbox&type=Date)](https://star-history.com/#chatboxai/chatbox&Date) + +## Contato + +[Twitter](https://x.com/ChatboxAI_HQ) | [Email](mailto:hi@chatboxai.com) + +## Licença + +[LICENSE](../LICENSE) diff --git a/doc/README-RU.md b/doc/README-RU.md new file mode 100644 index 0000000000..4a430ca88a --- /dev/null +++ b/doc/README-RU.md @@ -0,0 +1,356 @@ +

+ Языки / Languages: + English · + 简体中文 · + Español · + Français · + Português · + Русский · + Deutsch +

+ +Это репозиторий Chatbox Community Edition с открытым исходным кодом под лицензией GPLv3. + +[Chatbox снова становится open-source!](https://github.com/chatboxai/chatbox/issues/2266) + +Мы регулярно синхронизируем код из pro-репозитория в этот репозиторий и наоборот. + +### Скачать для Desktop + + + + + + + + + + + + + +
+ Windows + + MacOS + + Linux +
+ + +
+ Setup.exe +
+
+ + +
+ Intel +
+
+ + +
+ Apple Silicon +
+
+ + +
+ AppImage +
+
+ +### Скачать для iOS/Android + + + + + + + + + +.APK + + +Дополнительная информация: [chatboxai.app](https://chatboxai.app/) + +## Быстрый старт + +### Для конечных пользователей +1. Скачайте подходящий установщик для вашей платформы со [страницы релизов](https://github.com/chatboxai/chatbox/releases) +2. Установите и запустите Chatbox +3. Настройте провайдера ИИ (OpenAI, Claude и т. д.) в настройках +4. Начните общаться! + +### Системные требования + +| Платформа | Минимальная версия | Архитектура | +|----------|----------------|--------------| +| Windows | Windows 10 | x64 | +| macOS | macOS 11 (Big Sur) | Intel/Apple Silicon | +| Linux | Ubuntu 20.04+ / дистрибутивы с поддержкой AppImage | x64 | + +--- +
+ + Warp sponsorship + + +### [Warp — создан для программирования с несколькими AI-агентами.](https://go.warp.dev/chatbox) +[Доступен для MacOS, Linux и Windows](https://go.warp.dev/chatbox)
+
+ +
+ +

+ + + Chatbox + (Community Edition) + +

+

+ Ваш лучший AI-копилот на рабочем столе.
Chatbox — это desktop-клиент для ChatGPT, Claude и других LLM, доступный на Windows, Mac и Linux
+

+ +

+ +macOS + + +Windows + + +Linux + + +Downloads + + +Privacy + +

+ +Chatbox - Better UI & Desktop App for ChatGPT, Claude and other LLMs. | Product Hunt + + + + + + + + + + +## Возможности + +### 🤖 Поддержка AI-моделей +- **Поддержка нескольких провайдеров LLM** + :gear: Бесшовная интеграция с различными передовыми языковыми моделями: + - OpenAI (ChatGPT) + - Azure OpenAI + - Claude + - Google Gemini Pro + - Ollama (доступ к локальным моделям, таким как llama2, Mistral, Mixtral, codellama, vicuna, yi и solar) + - ChatGLM-6B + +- **Генерация изображений с Dall-E-3** + :art: Создавайте изображения из вашего воображения с помощью Dall-E-3. + +- **Расширенные промпты** + :speech_balloon: Продвинутые функции промптинга для уточнения и фокусировки запросов для получения лучших ответов. + +### 🖥️ Пользовательский опыт +- **Локальное хранение данных** + :floppy_disk: Ваши данные остаются на вашем устройстве, что гарантирует их сохранность и защищает вашу конфиденциальность. + +- **Установочные пакеты без развёртывания** + :package: Быстрый старт с загружаемыми установочными пакетами. Никакой сложной настройки! + +- **Эргономичный интерфейс и тёмная тема** + :new_moon: Удобный интерфейс с ночным режимом для снижения нагрузки на глаза при длительном использовании. + +- **Горячие клавиши** + :keyboard: Оставайтесь продуктивными с помощью сочетаний клавиш, ускоряющих рабочий процесс. + +- **Потоковые ответы** + :arrow_forward: Быстрые ответы на ваши запросы с мгновенными, постепенными ответами. + +### 📄 Контент и форматирование +- **Markdown, Latex и подсветка кода** + :scroll: Создавайте сообщения с полной мощью форматирования Markdown и Latex в сочетании с подсветкой синтаксиса для различных языков программирования, улучшая читаемость и оформление. + +- **Библиотека промптов и цитирование сообщений** + :books: Сохраняйте и организуйте промпты для повторного использования и цитируйте сообщения для контекста в обсуждениях. + +### 👥 Совместная работа и обмен +- **Командная работа** + :busts_in_silhouette: Легко сотрудничайте и делитесь ресурсами OpenAI API в своей команде. [Узнать больше](../team-sharing/README.md) + +### 🌐 Доступность платформ +- **Кроссплатформенный desktop** + :computer: Chatbox готов для пользователей Windows, Mac и Linux. + +- **Web-версия** + :globe_with_meridians: Используйте веб-приложение на любом устройстве с браузером, где угодно. + +- **Мобильные приложения** + :phone: Нативные приложения для iOS и Android для доступа в пути. + +### 🌍 Локализация +- **Многоязычная поддержка** + :earth_americas: Для глобальной аудитории с поддержкой нескольких языков: + - English + - 简体中文 (Simplified Chinese) + - 繁體中文 (Traditional Chinese) + - 日本語 (Japanese) + - 한국어 (Korean) + - Français (French) + - Deutsch (German) + - Русский (Russian) + - Español (Spanish) + +### ✨ Другие возможности +- **И многое другое...** + :sparkles: Постоянное улучшение опыта с новыми функциями! + +## FAQ + +- [Часто задаваемые вопросы](./FAQ.md) + +## Почему я создал Chatbox? + +Изначально я разработал Chatbox, потому что отлаживал некоторые промпты и мне нужен был простой и удобный инструмент для отладки промптов и API. Я подумал, что такой инструмент может понадобиться и другим людям, поэтому открыл его исходный код. + +Сначала я не знал, что он станет настолько популярным. Я прислушивался к отзывам open-source-сообщества и продолжал разрабатывать и улучшать его. Теперь это стало очень полезным AI desktop-приложением. Много пользователей любят Chatbox, и они используют его не только для разработки и отладки промптов, но и для повседневного общения, а также для более интересных вещей — например, с помощью хорошо продуманных промптов заставляют ИИ играть различные профессиональные роли и помогать им в повседневной работе... + +## Как внести вклад + +Мы приветствуем вклад сообщества! Вот как вы можете помочь сделать Chatbox лучше: + +### 🐛 Сообщение об ошибках +- Используйте [GitHub Issues](https://github.com/chatboxai/chatbox/issues) для сообщения об ошибках или запроса функций +- Перед созданием новой issue, пожалуйста, поищите существующие issues, чтобы избежать дубликатов +- Предоставьте подробную информацию, включая шаги воспроизведения, ожидаемое поведение и скриншоты, если применимо + +### 🔧 Pull Requests +1. Сделайте fork репозитория и создайте ветку от `main` +2. Внесите изменения и убедитесь, что код соответствует нашим стандартам кодирования +3. Тщательно протестируйте изменения +4. Обновите документацию при необходимости +5. Отправьте pull request с чётким описанием изменений + +### 🌍 Переводы +Помогите сделать Chatbox доступнее для большего числа людей, внося переводы: +- Файлы переводов находятся в каталоге `src/locales` +- Следуйте существующему формату перевода +- Отправьте PR с улучшениями перевода + +### 📖 Документация +- Улучшайте README, документацию API или руководства пользователя +- Исправляйте опечатки или уточняйте неясные инструкции +- Добавляйте примеры и руководства + +### 🌟 Другие способы внести вклад +- Поставьте звезду репозиторию, чтобы показать поддержку +- Расскажите о Chatbox другим +- Отвечайте на вопросы в [GitHub Discussions](https://github.com/chatboxai/chatbox/discussions) +- Предоставляйте обратную связь и предложения + +**Спасибо за ваш вклад! 🙏** + +## Разработка + +### Требования + +Перед началом убедитесь, что у вас установлено следующее: + +- **Node.js** (v20.x – v22.x) - [Скачать здесь](https://nodejs.org/) +- **pnpm** (v10.x или новее) - Установите через `corepack enable && corepack prepare pnpm@latest --activate` +- **Git** - [Скачать здесь](https://git-scm.com/) + +### Быстрая настройка + +1. **Клонируйте репозиторий** + ```bash + git clone https://github.com/chatboxai/chatbox.git + cd chatbox + ``` + +2. **Установите зависимости** + ```bash + pnpm install + ``` + +3. **Запустите сервер разработки** + ```bash + pnpm run dev + ``` + Приложение запустится в режиме разработки с включённым hot-reload. + +### Команды сборки + +| Команда | Описание | +|---------|-------------| +| `pnpm run dev` | Запуск сервера разработки с hot-reload | +| `pnpm run package` | Сборка и упаковка для текущей платформы | +| `pnpm run package:all` | Сборка и упаковка для всех платформ | +| `pnpm run build` | Сборка для production без упаковки | +| `pnpm run lint` | Запуск Biome для проверки качества кода | +| `pnpm run test` | Запуск тестового набора Vitest | + +### Структура проекта + +``` +chatbox/ +├── src/ +│ ├── main/ # Основной процесс Electron +│ ├── renderer/ # React renderer (UI) +│ ├── preload/ # Preload-скрипты Electron +│ └── shared/ # Общие утилиты +├── doc/ # Документация и ресурсы +├── resources/ # Ресурсы и иконки приложения +├── team-sharing/ # Функции командной работы +└── package.json # Конфигурация проекта +``` + +### Советы по разработке + +- Используйте `pnpm run lint` перед коммитом для обеспечения качества кода +- Следуйте существующему стилю кода и паттернам +- Тестируйте изменения в светлой и тёмной темах +- Обеспечивайте кроссплатформенную совместимость при изменении UI + +### Устранение неполадок + +**Проблема**: `pnpm install` завершается с ошибкой +- **Решение**: Убедитесь, что вы используете pnpm (не npm или yarn) и версия Node.js находится в требуемом диапазоне. Выполните `corepack enable`, если pnpm не найден. + +**Проблема**: Сборка завершается с ошибкой на Windows +- **Решение**: Выполните `pnpm config set script-shell "C:\\Program Files\\git\\bin\\bash.exe"`, если используете Git Bash + +**Проблема**: Изменения не отображаются в режиме разработки +- **Решение**: Остановите dev-сервер, удалите `node_modules/.vite` и перезапустите + +## История звёзд + +[![Star History Chart](https://api.star-history.com/svg?repos=chatboxai/chatbox&type=Date)](https://star-history.com/#chatboxai/chatbox&Date) + +## Контакты + +[Twitter](https://x.com/ChatboxAI_HQ) | [Email](mailto:hi@chatboxai.com) + +## Лицензия + +[LICENSE](../LICENSE)